@aws-amplify/ui-react-storage 3.11.0 → 3.12.1

package/dist/browser.js

@@ -4,7 +4,7 @@ Object.defineProperty(exports, '__esModule', { value: true });
 
 var internals = require('@aws-amplify/storage/internals');
 require('@aws-amplify/ui');
-var createStorageBrowser = require('./createStorageBrowser-CVfazB4S.js');
+var createStorageBrowser = require('./createStorageBrowser-C7xCWNpG.js');
 require('aws-amplify/storage');
 require('react');
 require('@aws-amplify/ui-react');

package/dist/{createStorageBrowser-CVfazB4S.js → createStorageBrowser-C7xCWNpG.js}

@@ -32,7 +32,7 @@ function _interopNamespace(e) {
 
 var React__namespace = /*#__PURE__*/_interopNamespace(React);
 
-const VERSION = '3.11.0';
+const VERSION = '3.12.1';
 
 const toAccessGrantPermission = (permission) => {
     let result = '';
@@ -389,7 +389,7 @@ const downloadHandler = ({ config, data: { key }, }) => {
     return { result };
 };
 
-const DEFAULT_PAGE_SIZE$4 = 1000;
+const DEFAULT_PAGE_SIZE$5 = 1000;
 const parseItems = (items, excludedPath) => items
     // remove root `key` from results
     .filter(({ path }) => path !== excludedPath)
@@ -422,7 +422,7 @@ const parseResult = ({ excludedSubpaths, items }, prefix) => filterDotItems([...
 const listLocationItemsHandler = async (input) => {
     const { config, prefix, options } = input;
     const { bucket: _bucket, credentials, customEndpoint, region, accountId, } = config;
-    const { exclude, delimiter, nextToken, pageSize: _pageSize = DEFAULT_PAGE_SIZE$4, ..._options } = options ?? {};
+    const { exclude, delimiter, nextToken, pageSize: _pageSize = DEFAULT_PAGE_SIZE$5, ..._options } = options ?? {};
     const bucket = { bucketName: _bucket, region };
     const subpathStrategy = {
         delimiter,
@@ -455,7 +455,7 @@ const listLocationItemsHandler = async (input) => {
         nextNextToken = output.nextToken;
         const items = parseResult(output, prefix);
         result.push(...(exclude ? items.filter((item) => item.type !== exclude) : items));
-    } while (nextNextToken && result.length < pageSize);
+    } while (nextNextToken && result.length < _pageSize);
     return { items: result, nextToken: nextNextToken };
 };
 
@@ -584,12 +584,21 @@ const uploadActionConfig = {
     },
     handler: defaultHandlers.upload,
 };
+const downloadActionConfig = {
+    viewName: 'DownloadView',
+    actionListItem: {
+        disable: (selected) => !selected || selected.length === 0,
+        hide: (permissions) => !permissions.includes('get'),
+        icon: 'download',
+        label: 'Download',
+    },
+    handler: defaultHandlers.download,
+};
 // Action view configs only, does not include `listLocationItems`
 const defaultActionViewConfigs = {
     copy: copyActionConfig,
     createFolder: createFolderActionConfig,
-    // provide `download` handler only; `download` does not have a dedicated view/config
-    download: defaultHandlers.download,
+    download: downloadActionConfig,
     delete: deleteActionConfig,
     upload: uploadActionConfig,
 };
@@ -2178,12 +2187,12 @@ const useList = (type) => {
 
 const resolveHandler = (value) => (ui.isFunction(value) ? value : value.handler);
 const getActionHandlers = (configs) => {
-    const { copy: copyConfig, createFolder: createFolderConfig, delete: deleteConfig, download, upload: uploadConfig, listLocationItems, listLocations, } = configs.default;
+    const { copy: copyConfig, createFolder: createFolderConfig, delete: deleteConfig, download: downloadConfig, upload: uploadConfig, listLocationItems, listLocations, } = configs.default;
     const defaultHandlers = {
         copy: copyConfig.handler,
         createFolder: createFolderConfig.handler,
         delete: deleteConfig.handler,
-        download,
+        download: 'handler' in downloadConfig ? downloadConfig.handler : downloadConfig,
         listLocationItems,
         listLocations,
         upload: uploadConfig.handler,
@@ -2905,6 +2914,8 @@ const DEFAULT_LOCATION_DETAIL_VIEW_DISPLAY_TEXT = {
                 return 'Create folder';
             case 'Upload':
                 return 'Upload';
+            case 'Download':
+                return 'Download';
             default:
                 return key;
         }
@@ -3049,10 +3060,31 @@ const DEFAULT_UPLOAD_VIEW_DISPLAY_TEXT = {
     title: 'Upload',
 };
 
+const DEFAULT_DOWNLOAD_VIEW_DISPLAY_TEXT = {
+    ...DEFAULT_ACTION_VIEW_DISPLAY_TEXT,
+    title: 'Download',
+    actionStartLabel: 'Download',
+    getActionCompleteMessage: (data) => {
+        const { counts } = data ?? {};
+        const { COMPLETE, FAILED, TOTAL } = counts ?? {};
+        if (COMPLETE === TOTAL) {
+            return { content: 'All files downloaded.', type: 'success' };
+        }
+        if (FAILED === TOTAL) {
+            return { content: 'All files failed to download.', type: 'error' };
+        }
+        return {
+            content: `${COMPLETE} files downloaded, ${FAILED} files failed to download.`,
+            type: 'error',
+        };
+    },
+};
+
 const DEFAULT_STORAGE_BROWSER_DISPLAY_TEXT = {
     CopyView: DEFAULT_COPY_VIEW_DISPLAY_TEXT,
     CreateFolderView: DEFAULT_CREATE_FOLDER_VIEW_DISPLAY_TEXT,
     DeleteView: DEFAULT_DELETE_VIEW_DISPLAY_TEXT,
+    DownloadView: DEFAULT_DOWNLOAD_VIEW_DISPLAY_TEXT,
     LocationDetailView: DEFAULT_LOCATION_DETAIL_VIEW_DISPLAY_TEXT,
     LocationsView: DEFAULT_LOCATIONS_VIEW_DISPLAY_TEXT,
     UploadView: DEFAULT_UPLOAD_VIEW_DISPLAY_TEXT,
@@ -3066,7 +3098,7 @@ function resolveDisplayText(displayText) {
     if (!displayText)
         return DEFAULT_STORAGE_BROWSER_DISPLAY_TEXT;
     // override
-    const { CopyView, CreateFolderView, DeleteView, LocationDetailView, LocationsView, UploadView, } = displayText;
+    const { CopyView, CreateFolderView, DeleteView, DownloadView, LocationDetailView, LocationsView, UploadView, } = displayText;
     return {
         CopyView: { ...DEFAULT_STORAGE_BROWSER_DISPLAY_TEXT.CopyView, ...CopyView },
         CreateFolderView: {
@@ -3077,6 +3109,10 @@ function resolveDisplayText(displayText) {
             ...DEFAULT_STORAGE_BROWSER_DISPLAY_TEXT.DeleteView,
             ...DeleteView,
         },
+        DownloadView: {
+            ...DEFAULT_STORAGE_BROWSER_DISPLAY_TEXT.DownloadView,
+            ...DownloadView,
+        },
         LocationDetailView: {
             ...DEFAULT_STORAGE_BROWSER_DISPLAY_TEXT.LocationDetailView,
             ...LocationDetailView,
@@ -3099,6 +3135,7 @@ function DisplayTextProvider({ children, displayText: _override, }) {
 
 const isCopyViewDisplayTextKey = (value) => !!DEFAULT_COPY_VIEW_DISPLAY_TEXT[value];
 const isDeleteViewDisplayTextKey = (value) => !!DEFAULT_DELETE_VIEW_DISPLAY_TEXT[value];
+const isDownloadViewDisplayTextKey = (value) => !!DEFAULT_DOWNLOAD_VIEW_DISPLAY_TEXT[value];
 
 function useResolveTableData(keys, { getCell, getHeader, getRowKey }, { items, props }) {
     return React__namespace["default"].useMemo(() => {
@@ -3222,7 +3259,7 @@ const cancel$1 = (data) => {
     return { key, type: 'button', content };
 };
 
-const status$2 = (data) => {
+const status$3 = (data) => {
     const key = getFileDataCellKey(data);
     const { item: { status }, props: { displayText }, } = data;
     const statusLabelKey = STATUS_LABELS[status];
@@ -3236,7 +3273,7 @@ const COPY_CELL_RESOLVERS = {
     folder: folder$1,
     type: type$1,
     size: size$1,
-    status: status$2,
+    status: status$3,
     cancel: cancel$1,
     /**
      * @deprecated
@@ -3259,6 +3296,72 @@ const COPY_TABLE_RESOLVERS = {
     getRowKey: ({ item }) => item.data.id,
 };
 
+const status$2 = (data) => {
+    const key = getFileDataCellKey(data);
+    const { item: { status }, props: { displayText }, } = data;
+    const statusLabelKey = STATUS_LABELS[status];
+    const text = isDeleteViewDisplayTextKey(statusLabelKey)
+        ? displayText[statusLabelKey]
+        : '';
+    return { key, type: 'text', content: { text } };
+};
+const DELETE_CELL_RESOLVERS = {
+    name: name$1,
+    folder: folder$1,
+    type: type$1,
+    size: size$1,
+    status: status$2,
+    cancel: cancel$1,
+    /**
+     * @deprecated
+     *
+     * non-upload view tables do not include "progress" headers but include here to
+     * keep TS happy as "progress" headers were included in display text interfaces
+     * and cannot be removed from the tables without a breaking change
+     */
+    progress: ui.noop,
+};
+const DELETE_TABLE_RESOLVERS = {
+    getCell: (data) => DELETE_CELL_RESOLVERS[data.key](data),
+    getHeader: ({ key, props: { displayText } }) => {
+        const text = displayText[`tableColumn${ui.capitalize(key)}Header`];
+        if (key === 'cancel') {
+            return { key, type: 'text', content: { text } };
+        }
+        return { key, type: 'sort', content: { label: text } };
+    },
+    getRowKey: ({ item }) => item.data.id,
+};
+
+const status$1 = (data) => {
+    const key = getFileDataCellKey(data);
+    const { item: { status }, props: { displayText }, } = data;
+    const statusLabelKey = STATUS_LABELS[status];
+    const text = isDownloadViewDisplayTextKey(statusLabelKey)
+        ? displayText[statusLabelKey]
+        : '';
+    return { key, type: 'text', content: { text } };
+};
+const DOWNLOAD_CELL_RESOLVERS = {
+    name: name$1,
+    folder: folder$1,
+    type: type$1,
+    size: size$1,
+    status: status$1,
+    cancel: cancel$1,
+};
+const DOWNLOAD_TABLE_RESOLVERS = {
+    getCell: (data) => DOWNLOAD_CELL_RESOLVERS[data.key](data),
+    getHeader: ({ key, props: { displayText } }) => {
+        const text = displayText[`tableColumn${ui.capitalize(key)}Header`];
+        if (key === 'cancel') {
+            return { key, type: 'text', content: { text } };
+        }
+        return { key, type: 'sort', content: { label: text } };
+    },
+    getRowKey: ({ item }) => item.data.id,
+};
+
 const UPLOAD_TABLE_KEYS = [
     'name',
     'folder',
@@ -3293,7 +3396,7 @@ const size = (data) => {
     const displayValue = getFileSize(value);
     return { key, type: 'number', content: { value, displayValue } };
 };
-const status$1 = (data) => {
+const status = (data) => {
     const key = getUploadCellKey(data);
     const { item: { status }, props: { displayText }, } = data;
     const text = displayText[STATUS_LABELS[status]];
@@ -3351,7 +3454,7 @@ const UPLOAD_CELL_RESOLVERS = {
     name,
     progress,
     size,
-    status: status$1,
+    status,
     type,
 };
 const UPLOAD_TABLE_RESOLVERS = {
@@ -3366,47 +3469,10 @@ const UPLOAD_TABLE_RESOLVERS = {
     getRowKey: ({ item }) => item.data.id,
 };
 
-const status = (data) => {
-    const key = getFileDataCellKey(data);
-    const { item: { status }, props: { displayText }, } = data;
-    const statusLabelKey = STATUS_LABELS[status];
-    const text = isDeleteViewDisplayTextKey(statusLabelKey)
-        ? displayText[statusLabelKey]
-        : '';
-    return { key, type: 'text', content: { text } };
-};
-const DELETE_CELL_RESOLVERS = {
-    name: name$1,
-    folder: folder$1,
-    type: type$1,
-    size: size$1,
-    status,
-    cancel: cancel$1,
-    /**
-     * @deprecated
-     *
-     * non-upload view tables do not include "progress" headers but include here to
-     * keep TS happy as "progress" headers were included in display text interfaces
-     * and cannot be removed from the tables without a breaking change
-     */
-    progress: ui.noop,
-};
-const DELETE_TABLE_RESOLVERS = {
-    getCell: (data) => DELETE_CELL_RESOLVERS[data.key](data),
-    getHeader: ({ key, props: { displayText } }) => {
-        const text = displayText[`tableColumn${ui.capitalize(key)}Header`];
-        if (key === 'cancel') {
-            return { key, type: 'text', content: { text } };
-        }
-        return { key, type: 'sort', content: { label: text } };
-    },
-    getRowKey: ({ item }) => item.data.id,
-};
-
 function UploadViewProvider({ children, ...props }) {
     const { UploadView: displayText } = useDisplayText();
     const { actionCancelLabel, actionDestinationLabel, actionExitLabel, actionStartLabel, addFilesLabel, addFolderLabel, statusDisplayCanceledLabel, statusDisplayCompletedLabel, statusDisplayFailedLabel, statusDisplayQueuedLabel, overwriteToggleLabel, title, getActionCompleteMessage, getFilesValidationMessage, } = displayText;
-    const { isOverwritingEnabled, isProcessing, isProcessingComplete, location, tasks: items, statusCounts, invalidFiles, onActionStart, onActionCancel, onDropFiles, onActionExit, onTaskRemove, onSelectFiles, onToggleOverwrite, } = props;
+    const { hasNextPage, highestPageVisited, page, isOverwritingEnabled, isProcessing, isProcessingComplete, location, tasks: items, statusCounts, invalidFiles, onActionStart, onActionCancel, onDropFiles, onPaginate, onActionExit, onTaskRemove, onSelectFiles, onToggleOverwrite, } = props;
     const isActionStartDisabled = isProcessing || isProcessingComplete || statusCounts.TOTAL === 0;
     const isActionCancelDisabled = !isProcessing || isProcessingComplete;
     const isAddFilesDisabled = isProcessing || isProcessingComplete;
@@ -3440,6 +3506,11 @@ function UploadViewProvider({ children, ...props }) {
             isOverwriteToggleDisabled: isProcessing || isProcessingComplete,
             isOverwritingEnabled,
             overwriteToggleLabel,
+            paginationData: {
+                page,
+                hasNextPage,
+                highestPageVisited,
+            },
             destination: location,
             message: actionCompleteMessage ?? filesValidationMessage,
             statusCounts,
@@ -3449,7 +3520,7 @@ function UploadViewProvider({ children, ...props }) {
             statusDisplayQueuedLabel,
             tableData,
             title,
-        }, onActionCancel: onActionCancel, onActionExit: onActionExit, onActionStart: onActionStart, onAddFiles: () => {
+        }, onActionCancel: onActionCancel, onActionExit: onActionExit, onActionStart: onActionStart, onPaginate: onPaginate, onAddFiles: () => {
             onSelectFiles('FILE');
         }, onAddFolder: () => {
             onSelectFiles('FOLDER');
@@ -3581,6 +3652,41 @@ function FileItemsProvider({ children, validateFile, }) {
 
 const DEFAULT_OVERWRITE_ENABLED = false;
 
+const DEFAULT_PAGE_SIZE$4 = 100;
+const usePaginate = ({ items, onPaginate, page = 1, pageSize = DEFAULT_PAGE_SIZE$4, }) => {
+    const [currentPage, setCurrentPage] = React__namespace["default"].useState(page);
+    const visitedRef = React__namespace["default"].useRef(page);
+    const handleReset = React__namespace["default"].useRef(() => {
+        setCurrentPage(page);
+        // set `visitedRef` to initially provided `page`
+        visitedRef.current = page;
+    }).current;
+    return React__namespace["default"].useMemo(() => {
+        const hasItems = Array.isArray(items);
+        const highestPageVisited = visitedRef.current;
+        const isFirstPage = currentPage === 1;
+        const start = isFirstPage ? 0 : (currentPage - 1) * pageSize;
+        const end = isFirstPage ? pageSize : currentPage * pageSize;
+        const pageItems = hasItems ? items.slice(start, end) : [];
+        return {
+            currentPage,
+            handlePaginate: (page) => {
+                if (page < 1)
+                    return;
+                if (ui.isFunction(onPaginate))
+                    onPaginate(page);
+                if (page > currentPage && page > highestPageVisited)
+                    visitedRef.current = page;
+                setCurrentPage(page);
+            },
+            handleReset,
+            highestPageVisited,
+            pageItems,
+        };
+    }, [currentPage, handleReset, items, onPaginate, pageSize]);
+};
+
+const DEFAULT_PAGE_SIZE$3 = 100;
 const useUploadView = (options) => {
     const { onExit: _onExit } = options ?? {};
     const [{ location }, storeDispatch] = useStore();
@@ -3593,6 +3699,9 @@ const useUploadView = (options) => {
         preventOverwrite: !isOverwritingEnabled,
     })), [validItems, isOverwritingEnabled, location.key]);
     const [{ isProcessing, isProcessingComplete, statusCounts, tasks }, handleUploads,] = useAction('upload', { items });
+    const { currentPage, handlePaginate, pageItems: pageTasks, } = usePaginate({
+        items: tasks,
+    });
     const onDropFiles = (files) => {
         if (files) {
             fileItemsDispatch({ type: 'ADD_FILES', files });
@@ -3627,11 +3736,15 @@ const useUploadView = (options) => {
         location,
         invalidFiles,
         statusCounts,
-        tasks,
+        tasks: pageTasks,
+        page: currentPage,
+        hasNextPage: currentPage * DEFAULT_PAGE_SIZE$3 < items.length,
+        highestPageVisited: Math.ceil(items.length / DEFAULT_PAGE_SIZE$3),
         onActionCancel,
         onActionExit,
         onActionStart,
         onDropFiles,
+        onPaginate: handlePaginate,
         onTaskRemove,
         onSelectFiles,
         onToggleOverwrite,
@@ -3647,6 +3760,7 @@ const UploadView = ({ className, ...props }) => {
             React__namespace["default"].createElement(ViewElement, { className: `${STORAGE_BROWSER_BLOCK}__controls` },
                 React__namespace["default"].createElement(OverwriteToggleControl, null),
                 React__namespace["default"].createElement(ViewElement, { className: `${STORAGE_BROWSER_BLOCK}__buttons` },
+                    React__namespace["default"].createElement(PaginationControl, null),
                     React__namespace["default"].createElement(AddFolderControl, null),
                     React__namespace["default"].createElement(AddFilesControl, null))),
             React__namespace["default"].createElement(DropZoneControl, null,
@@ -3666,6 +3780,7 @@ UploadView.displayName = 'UploadView';
 UploadView.Provider = UploadViewProvider;
 UploadView.AddFiles = AddFilesControl;
 UploadView.AddFolder = AddFolderControl;
+UploadView.Pagination = PaginationControl;
 UploadView.Cancel = ActionCancelControl;
 UploadView.Destination = ActionDestinationControl;
 UploadView.DropZone = DropZoneControl;
@@ -3935,40 +4050,6 @@ function LocationItemsProvider({ children, }) {
     return (React__namespace["default"].createElement(LocationItemsContext.Provider, { value: value }, children));
 }
 
-const DEFAULT_PAGE_SIZE$3 = 100;
-const usePaginate = ({ items, onPaginate, page = 1, pageSize = DEFAULT_PAGE_SIZE$3, }) => {
-    const [currentPage, setCurrentPage] = React__namespace["default"].useState(page);
-    const visitedRef = React__namespace["default"].useRef(page);
-    const handleReset = React__namespace["default"].useRef(() => {
-        setCurrentPage(page);
-        // set `visitedRef` to initially provided `page`
-        visitedRef.current = page;
-    }).current;
-    return React__namespace["default"].useMemo(() => {
-        const hasItems = Array.isArray(items);
-        const highestPageVisited = visitedRef.current;
-        const isFirstPage = currentPage === 1;
-        const start = isFirstPage ? 0 : (currentPage - 1) * pageSize;
-        const end = isFirstPage ? pageSize : currentPage * pageSize;
-        const pageItems = hasItems ? items.slice(start, end) : [];
-        return {
-            currentPage,
-            handlePaginate: (page) => {
-                if (page < 1)
-                    return;
-                if (ui.isFunction(onPaginate))
-                    onPaginate(page);
-                if (page > currentPage)
-                    visitedRef.current = page;
-                setCurrentPage(page);
-            },
-            handleReset,
-            highestPageVisited,
-            pageItems,
-        };
-    }, [currentPage, handleReset, items, onPaginate, pageSize]);
-};
-
 function useSearch(props) {
     const { onSearch } = props;
     const [searchQuery, setQuery] = React__namespace["default"].useState('');
@@ -4218,13 +4299,13 @@ function DeleteViewProvider({ children, ...props }) {
 }
 
 // assign to constant to ensure referential equality
-const EMPTY_ITEMS = [];
+const EMPTY_ITEMS$1 = [];
 const useDeleteView = (options) => {
     const { onExit: _onExit } = options ?? {};
     const [{ location }, storeDispatch] = useStore();
     const [locationItems, locationItemsDispatch] = useLocationItems();
     const { current } = location;
-    const { fileDataItems: items = EMPTY_ITEMS } = locationItems;
+    const { fileDataItems: items = EMPTY_ITEMS$1 } = locationItems;
     const [processState, handleProcess] = useAction('delete', { items });
     const { isProcessing, isProcessingComplete, statusCounts, tasks } = processState;
     const onActionStart = () => {
@@ -4290,10 +4371,117 @@ DeleteView.Statuses = StatusDisplayControl;
 DeleteView.TasksTable = DataTableControl;
 DeleteView.Title = TitleControl;
 
+function DownloadViewProvider({ children, ...props }) {
+    const { DownloadView: displayText } = useDisplayText();
+    const { actionCancelLabel, actionExitLabel, actionStartLabel, title, statusDisplayCanceledLabel, statusDisplayCompletedLabel, statusDisplayFailedLabel, statusDisplayQueuedLabel, getActionCompleteMessage, } = displayText;
+    const { isProcessing, isProcessingComplete, statusCounts, tasks: items, onActionCancel, onActionStart, onActionExit, onTaskRemove, } = props;
+    const message = isProcessingComplete
+        ? getActionCompleteMessage({ counts: statusCounts })
+        : undefined;
+    const tableData = useResolveTableData(FILE_DATA_ITEM_TABLE_KEYS, DOWNLOAD_TABLE_RESOLVERS, {
+        items,
+        props: { displayText, isProcessing, onTaskRemove },
+    });
+    return (React__namespace["default"].createElement(ControlsContextProvider, { data: {
+            actionCancelLabel,
+            actionExitLabel,
+            actionStartLabel,
+            isActionCancelDisabled: !isProcessing || isProcessingComplete,
+            isActionExitDisabled: isProcessing,
+            isActionStartDisabled: isProcessing || isProcessingComplete,
+            statusDisplayCanceledLabel,
+            statusDisplayCompletedLabel,
+            statusDisplayFailedLabel,
+            statusDisplayQueuedLabel,
+            statusCounts,
+            tableData,
+            title,
+            message,
+        }, onActionStart: onActionStart, onActionExit: onActionExit, onActionCancel: onActionCancel }, children));
+}
+
+// assign to constant to ensure referential equality
+const EMPTY_ITEMS = [];
+const useDownloadView = (options) => {
+    const { onExit: _onExit } = options ?? {};
+    const [{ location }, storeDispatch] = useStore();
+    const [locationItems, locationItemsDispatch] = useLocationItems();
+    const { current } = location;
+    const { fileDataItems: items = EMPTY_ITEMS } = locationItems;
+    const [processState, handleProcess] = useAction('download', {
+        items,
+    });
+    const { isProcessing, isProcessingComplete, statusCounts, tasks } = processState;
+    const onActionStart = () => {
+        if (!current)
+            return;
+        handleProcess();
+    };
+    const onActionCancel = () => {
+        tasks.forEach((task) => {
+            // Calling cancel on task works only on queued tasks.
+            // In case of download, all download presigned url open at once
+            // When certain threshold is reached for queuing inside StorageBrowser, cancel might be possible.
+            if (ui.isFunction(task.cancel))
+                task.cancel();
+        });
+    };
+    const onActionExit = () => {
+        // clear files state
+        locationItemsDispatch({ type: 'RESET_LOCATION_ITEMS' });
+        // clear selected action
+        storeDispatch({ type: 'RESET_ACTION_TYPE' });
+        if (ui.isFunction(_onExit))
+            _onExit(current);
+    };
+    const onTaskRemove = React__namespace["default"].useCallback(({ data }) => {
+        locationItemsDispatch({ type: 'REMOVE_LOCATION_ITEM', id: data.id });
+    }, [locationItemsDispatch]);
+    return {
+        isProcessing,
+        isProcessingComplete,
+        location,
+        statusCounts,
+        tasks,
+        onActionCancel,
+        onActionExit,
+        onActionStart,
+        onTaskRemove,
+    };
+};
+
+const DownloadView = ({ className, ...props }) => {
+    const state = useDownloadView(props);
+    return (React__namespace["default"].createElement(ViewElement, { className: ui.classNames(STORAGE_BROWSER_BLOCK, className) },
+        React__namespace["default"].createElement(DownloadViewProvider, { ...state },
+            React__namespace["default"].createElement(ActionExitControl, null),
+            React__namespace["default"].createElement(TitleControl, null),
+            React__namespace["default"].createElement(ViewElement, { className: `${STORAGE_BROWSER_BLOCK}__data-table` },
+                React__namespace["default"].createElement(DataTableControl, null)),
+            React__namespace["default"].createElement(ViewElement, { className: `${STORAGE_BROWSER_BLOCK}__summary` },
+                React__namespace["default"].createElement(StatusDisplayControl, null)),
+            React__namespace["default"].createElement(ViewElement, { className: `${STORAGE_BROWSER_BLOCK}__footer` },
+                React__namespace["default"].createElement(ViewElement, { className: `${STORAGE_BROWSER_BLOCK}__message` },
+                    React__namespace["default"].createElement(MessageControl, null)),
+                React__namespace["default"].createElement(ViewElement, { className: `${STORAGE_BROWSER_BLOCK}__buttons` },
+                    React__namespace["default"].createElement(ActionCancelControl, null),
+                    React__namespace["default"].createElement(ActionStartControl, null))))));
+};
+DownloadView.displayName = 'DownloadView';
+DownloadView.Provider = DownloadViewProvider;
+DownloadView.Cancel = ActionCancelControl;
+DownloadView.Exit = ActionExitControl;
+DownloadView.Message = MessageControl;
+DownloadView.Start = ActionStartControl;
+DownloadView.Statuses = StatusDisplayControl;
+DownloadView.TasksTable = DataTableControl;
+DownloadView.Title = TitleControl;
+
 const DEFAULT_ACTION_VIEWS = {
     createFolder: CreateFolderView,
     copy: CopyView,
     delete: DeleteView,
+    download: DownloadView,
     upload: UploadView,
 };
 const ActionViewsContext = React__namespace["default"].createContext({
@@ -5141,6 +5329,7 @@ function useViews() {
 const USE_VIEW_HOOKS = {
     Copy: useCopyView,
     CreateFolder: useCreateFolderView,
+    Download: useDownloadView,
     Delete: useDeleteView,
     LocationDetail: useLocationDetailView,
     Locations: useLocationsView,
@@ -5254,6 +5443,7 @@ function createStorageBrowser(input) {
     StorageBrowser.CopyView = CopyView;
     StorageBrowser.CreateFolderView = CreateFolderView;
     StorageBrowser.DeleteView = DeleteView;
+    StorageBrowser.DownloadView = DownloadView;
     StorageBrowser.UploadView = UploadView;
     StorageBrowser.Provider = Provider;
     StorageBrowser.displayName = 'StorageBrowser';

package/dist/esm/components/StorageBrowser/actions/configs/defaults.mjs

@@ -41,12 +41,21 @@ const uploadActionConfig = {
     },
     handler: defaultHandlers.upload,
 };
+const downloadActionConfig = {
+    viewName: 'DownloadView',
+    actionListItem: {
+        disable: (selected) => !selected || selected.length === 0,
+        hide: (permissions) => !permissions.includes('get'),
+        icon: 'download',
+        label: 'Download',
+    },
+    handler: defaultHandlers.download,
+};
 // Action view configs only, does not include `listLocationItems`
 const defaultActionViewConfigs = {
     copy: copyActionConfig,
     createFolder: createFolderActionConfig,
-    // provide `download` handler only; `download` does not have a dedicated view/config
-    download: defaultHandlers.download,
+    download: downloadActionConfig,
     delete: deleteActionConfig,
     upload: uploadActionConfig,
 };
@@ -57,4 +66,4 @@ const defaultActionConfigs = {
     listLocationItems: defaultHandlers.listLocationItems,
 };
 
-export { DEFAULT_ACTION_VIEW_TYPES, copyActionConfig, createFolderActionConfig, defaultActionConfigs, defaultActionViewConfigs, deleteActionConfig, isDefaultActionViewType, uploadActionConfig };
+export { DEFAULT_ACTION_VIEW_TYPES, copyActionConfig, createFolderActionConfig, defaultActionConfigs, defaultActionViewConfigs, deleteActionConfig, downloadActionConfig, isDefaultActionViewType, uploadActionConfig };

package/dist/esm/components/StorageBrowser/actions/handlers/listLocationItems.mjs

@@ -66,7 +66,7 @@ const listLocationItemsHandler = async (input) => {
         nextNextToken = output.nextToken;
         const items = parseResult(output, prefix);
         result.push(...(exclude ? items.filter((item) => item.type !== exclude) : items));
-    } while (nextNextToken && result.length < pageSize);
+    } while (nextNextToken && result.length < _pageSize);
     return { items: result, nextToken: nextNextToken };
 };
 

package/dist/esm/components/StorageBrowser/createStorageBrowser/StorageBrowserDefault.mjs

@@ -15,6 +15,7 @@ import '../actions/configs/context.mjs';
 import '../actions/configs/defaults.mjs';
 import '../views/LocationActionView/CreateFolderView/CreateFolderView.mjs';
 import '../views/LocationActionView/DeleteView/DeleteView.mjs';
+import '../views/LocationActionView/DownloadView/DownloadView.mjs';
 import '../views/context/actionViews.mjs';
 import '../views/LocationActionView/UploadView/UploadView.mjs';
 import '../fileItems/context.mjs';

package/dist/esm/components/StorageBrowser/createStorageBrowser/createProvider.mjs

@@ -26,6 +26,7 @@ import { ViewsProvider } from '../views/context/views.mjs';
 import '../views/LocationActionView/CopyView/CopyView.mjs';
 import '../views/LocationActionView/CreateFolderView/CreateFolderView.mjs';
 import '../views/LocationActionView/DeleteView/DeleteView.mjs';
+import '../views/LocationActionView/DownloadView/DownloadView.mjs';
 import '../views/context/actionViews.mjs';
 import '../views/LocationActionView/UploadView/UploadView.mjs';
 import '../views/LocationDetailView/LocationDetailView.mjs';

package/dist/esm/components/StorageBrowser/createStorageBrowser/createStorageBrowser.mjs

@@ -20,6 +20,7 @@ import '../locationItems/context.mjs';
 import '../store/context.mjs';
 import { CreateFolderView } from '../views/LocationActionView/CreateFolderView/CreateFolderView.mjs';
 import { DeleteView } from '../views/LocationActionView/DeleteView/DeleteView.mjs';
+import { DownloadView } from '../views/LocationActionView/DownloadView/DownloadView.mjs';
 import { LocationActionView } from '../views/LocationActionView/LocationActionView.mjs';
 import { UploadView } from '../views/LocationActionView/UploadView/UploadView.mjs';
 import '../fileItems/context.mjs';
@@ -61,6 +62,7 @@ function createStorageBrowser(input) {
     StorageBrowser.CopyView = CopyView;
     StorageBrowser.CreateFolderView = CreateFolderView;
     StorageBrowser.DeleteView = DeleteView;
+    StorageBrowser.DownloadView = DownloadView;
     StorageBrowser.UploadView = UploadView;
     StorageBrowser.Provider = Provider;
     StorageBrowser.displayName = 'StorageBrowser';