@aws-amplify/ui-react-storage 3.3.10 → 3.4.1

package/dist/esm/components/StorageBrowser/displayText/libraries/en/copyView.mjs

@@ -0,0 +1,54 @@
+import { DEFAULT_ACTION_VIEW_DISPLAY_TEXT } from './shared.mjs';
+
+const DEFAULT_COPY_VIEW_DISPLAY_TEXT = {
+    ...DEFAULT_ACTION_VIEW_DISPLAY_TEXT,
+    title: 'Copy',
+    actionStartLabel: 'Copy',
+    actionDestinationLabel: 'Copy destination',
+    getListFoldersResultsMessage: ({ folders, query, message, hasError, hasExhaustedSearch, }) => {
+        if (!folders?.length) {
+            return {
+                content: query
+                    ? `No folders found matching "${query}"`
+                    : 'No subfolders found within selected folder.',
+                type: 'info',
+            };
+        }
+        if (message && !!query) {
+            return { content: 'Error loading folders.', type: 'error' };
+        }
+        if (hasError) {
+            return { content: 'Error loading folders.', type: 'error' };
+        }
+        if (hasExhaustedSearch) {
+            return {
+                content: 'Showing results for up to the first 10,000 items.',
+                type: 'info',
+            };
+        }
+    },
+    loadingIndicatorLabel: 'Loading',
+    overwriteWarningMessage: 'Copied files will overwrite existing files at selected destination.',
+    searchPlaceholder: 'Search for folders',
+    getActionCompleteMessage: (data) => {
+        const { counts } = data ?? {};
+        const { COMPLETE, FAILED, TOTAL } = counts ?? {};
+        if (COMPLETE === TOTAL) {
+            return {
+                content: 'All files copied.',
+                type: 'success',
+            };
+        }
+        if (FAILED === TOTAL) {
+            return { content: 'All files failed to copy.', type: 'error' };
+        }
+        return {
+            content: `${COMPLETE} files copied, ${FAILED} files failed to copy.`,
+            type: 'error',
+        };
+    },
+    searchSubmitLabel: 'Submit',
+    searchClearLabel: 'Clear search',
+};
+
+export { DEFAULT_COPY_VIEW_DISPLAY_TEXT };

package/dist/esm/components/StorageBrowser/displayText/libraries/en/createFolderView.mjs

@@ -0,0 +1,29 @@
+import { DEFAULT_ACTION_VIEW_DISPLAY_TEXT } from './shared.mjs';
+
+const DEFAULT_CREATE_FOLDER_VIEW_DISPLAY_TEXT = {
+    ...DEFAULT_ACTION_VIEW_DISPLAY_TEXT,
+    title: 'Create folder',
+    actionStartLabel: 'Create folder',
+    folderNameLabel: 'Folder name',
+    folderNamePlaceholder: 'Folder name cannot contain "/", nor end or start with "."',
+    getValidationMessage: () => 'Folder name cannot contain "/", nor end or start with "."',
+    getActionCompleteMessage: (data) => {
+        const { counts } = data ?? {};
+        const { FAILED, OVERWRITE_PREVENTED } = counts ?? {};
+        if (OVERWRITE_PREVENTED) {
+            return {
+                content: 'A folder already exists with the provided name',
+                type: 'warning',
+            };
+        }
+        if (FAILED) {
+            return {
+                content: 'There was an issue creating the folder.',
+                type: 'error',
+            };
+        }
+        return { content: 'Folder created.', type: 'success' };
+    },
+};
+
+export { DEFAULT_CREATE_FOLDER_VIEW_DISPLAY_TEXT };

package/dist/esm/components/StorageBrowser/displayText/libraries/en/default.mjs

@@ -0,0 +1,17 @@
+import { DEFAULT_CREATE_FOLDER_VIEW_DISPLAY_TEXT } from './createFolderView.mjs';
+import { DEFAULT_COPY_VIEW_DISPLAY_TEXT } from './copyView.mjs';
+import { DEFAULT_DELETE_VIEW_DISPLAY_TEXT } from './deleteView.mjs';
+import { DEFAULT_LOCATION_DETAIL_VIEW_DISPLAY_TEXT } from './locationDetailView.mjs';
+import { DEFAULT_LOCATIONS_VIEW_DISPLAY_TEXT } from './locationsView.mjs';
+import { DEFAULT_UPLOAD_VIEW_DISPLAY_TEXT } from './uploadView.mjs';
+
+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,
+    LocationDetailView: DEFAULT_LOCATION_DETAIL_VIEW_DISPLAY_TEXT,
+    LocationsView: DEFAULT_LOCATIONS_VIEW_DISPLAY_TEXT,
+    UploadView: DEFAULT_UPLOAD_VIEW_DISPLAY_TEXT,
+};
+
+export { DEFAULT_STORAGE_BROWSER_DISPLAY_TEXT };

package/dist/esm/components/StorageBrowser/displayText/libraries/en/deleteView.mjs

@@ -0,0 +1,23 @@
+import { DEFAULT_ACTION_VIEW_DISPLAY_TEXT } from './shared.mjs';
+
+const DEFAULT_DELETE_VIEW_DISPLAY_TEXT = {
+    ...DEFAULT_ACTION_VIEW_DISPLAY_TEXT,
+    title: 'Delete',
+    actionStartLabel: 'Delete',
+    getActionCompleteMessage: (data) => {
+        const { counts } = data ?? {};
+        const { COMPLETE, FAILED, TOTAL } = counts ?? {};
+        if (COMPLETE === TOTAL) {
+            return { content: 'All files deleted.', type: 'success' };
+        }
+        if (FAILED === TOTAL) {
+            return { content: 'All files failed to delete.', type: 'error' };
+        }
+        return {
+            content: `${COMPLETE} files deleted, ${FAILED} files failed to delete.`,
+            type: 'error',
+        };
+    },
+};
+
+export { DEFAULT_DELETE_VIEW_DISPLAY_TEXT };

package/dist/esm/components/StorageBrowser/displayText/libraries/en/locationDetailView.mjs

@@ -0,0 +1,61 @@
+import { DEFAULT_LIST_VIEW_DISPLAY_TEXT } from './shared.mjs';
+
+const DEFAULT_ERROR_MESSAGE = 'There was an error loading items.';
+const DEFAULT_LOCATION_DETAIL_VIEW_DISPLAY_TEXT = {
+    ...DEFAULT_LIST_VIEW_DISPLAY_TEXT,
+    getListItemsResultMessage: (data) => {
+        const { items, hasExhaustedSearch, hasError = false, message, isLoading, } = data ?? {};
+        if (isLoading) {
+            return undefined;
+        }
+        if (hasError) {
+            return {
+                type: 'error',
+                content: message ?? DEFAULT_ERROR_MESSAGE,
+            };
+        }
+        if (!items?.length) {
+            return {
+                type: 'info',
+                content: 'No files.',
+            };
+        }
+        if (hasExhaustedSearch) {
+            return {
+                type: 'info',
+                content: `Showing results for up to the first 10,000 items.`,
+            };
+        }
+        // TODO: add more cases as needed
+        return undefined;
+    },
+    searchSubfoldersToggleLabel: 'Include subfolders',
+    searchPlaceholder: 'Search current folder',
+    tableColumnLastModifiedHeader: 'Last modified',
+    tableColumnNameHeader: 'Name',
+    tableColumnSizeHeader: 'Size',
+    tableColumnTypeHeader: 'Type',
+    selectFileLabel: 'Select file',
+    selectAllFilesLabel: 'Select all files',
+    getActionListItemLabel: (key = '') => {
+        switch (key) {
+            case 'Copy':
+                return 'Copy';
+            case 'Delete':
+                return 'Delete';
+            case 'Create folder':
+                return 'Create folder';
+            case 'Upload':
+                return 'Upload';
+            default:
+                return key;
+        }
+    },
+    getTitle: (location) => {
+        const { current, key } = location;
+        const { bucket = '' } = current ?? {};
+        return key || bucket;
+    },
+};
+
+export { DEFAULT_ERROR_MESSAGE, DEFAULT_LOCATION_DETAIL_VIEW_DISPLAY_TEXT };

package/dist/esm/components/StorageBrowser/displayText/libraries/en/locationsView.mjs

@@ -0,0 +1,54 @@
+import { DEFAULT_LIST_VIEW_DISPLAY_TEXT } from './shared.mjs';
+
+const DEFAULT_ERROR_MESSAGE = 'There was an error loading locations.';
+const DEFAULT_LOCATIONS_VIEW_DISPLAY_TEXT = {
+    ...DEFAULT_LIST_VIEW_DISPLAY_TEXT,
+    title: 'Home',
+    searchPlaceholder: 'Filter folders and files',
+    getListLocationsResultMessage: (data) => {
+        const { isLoading, locations, hasExhaustedSearch, hasError = false, message, } = data ?? {};
+        if (isLoading) {
+            return undefined;
+        }
+        if (hasError) {
+            return {
+                type: 'error',
+                content: message ?? DEFAULT_ERROR_MESSAGE,
+            };
+        }
+        if (locations?.length === 0 && !hasExhaustedSearch) {
+            return {
+                type: 'info',
+                content: 'No folders or files.',
+            };
+        }
+        if (hasExhaustedSearch) {
+            return {
+                type: 'info',
+                content: `Showing results for up to the first 10,000 items.`,
+            };
+        }
+        // TODO: add more cases as needed
+        return undefined;
+    },
+    getPermissionName: (permissions) => {
+        let text = '';
+        if (permissions.includes('get') || permissions.includes('list')) {
+            text = 'Read';
+        }
+        if (permissions.includes('write') || permissions.includes('delete')) {
+            text = text ? 'Read/Write' : 'Write';
+        }
+        if (!text) {
+            text = permissions.join('/');
+        }
+        return text;
+    },
+    getDownloadLabel: (fileName) => `Download ${fileName}`,
+    tableColumnBucketHeader: 'Bucket',
+    tableColumnFolderHeader: 'Folder',
+    tableColumnPermissionsHeader: 'Permissions',
+    tableColumnActionsHeader: 'Actions',
+};
+
+export { DEFAULT_ERROR_MESSAGE, DEFAULT_LOCATIONS_VIEW_DISPLAY_TEXT };

package/dist/esm/components/StorageBrowser/displayText/libraries/en/shared.mjs

@@ -0,0 +1,34 @@
+const DEFAULT_ACTION_VIEW_DISPLAY_TEXT = {
+    actionCancelLabel: 'Cancel',
+    actionExitLabel: 'Exit',
+    actionDestinationLabel: 'Destination',
+    statusDisplayCanceledLabel: 'Canceled',
+    statusDisplayCompletedLabel: 'Completed',
+    statusDisplayFailedLabel: 'Failed',
+    statusDisplayInProgressLabel: 'In progress',
+    statusDisplayTotalLabel: 'Total',
+    statusDisplayQueuedLabel: 'Not started',
+    // empty by default
+    tableColumnCancelHeader: '',
+    tableColumnStatusHeader: 'Status',
+    tableColumnFolderHeader: 'Folder',
+    tableColumnNameHeader: 'Name',
+    tableColumnTypeHeader: 'Type',
+    tableColumnSizeHeader: 'Size',
+    tableColumnProgressHeader: 'Progress',
+};
+const DEFAULT_LIST_VIEW_DISPLAY_TEXT = {
+    loadingIndicatorLabel: 'Loading',
+    searchSubmitLabel: 'Submit',
+    searchClearLabel: 'Clear search',
+    getDateDisplayValue: (date) => new Intl.DateTimeFormat('en-US', {
+        month: 'short',
+        day: 'numeric',
+        hour: 'numeric',
+        year: 'numeric',
+        minute: 'numeric',
+        hourCycle: 'h12',
+    }).format(date),
+};
+
+export { DEFAULT_ACTION_VIEW_DISPLAY_TEXT, DEFAULT_LIST_VIEW_DISPLAY_TEXT };

package/dist/esm/components/StorageBrowser/displayText/libraries/en/uploadView.mjs

@@ -0,0 +1,87 @@
+import { DEFAULT_ACTION_VIEW_DISPLAY_TEXT } from './shared.mjs';
+import '@aws-amplify/ui';
+import { isFileTooBig } from '../../../validators/isFileTooBig.mjs';
+
+const DEFAULT_UPLOAD_VIEW_DISPLAY_TEXT = {
+    ...DEFAULT_ACTION_VIEW_DISPLAY_TEXT,
+    title: 'Upload',
+    actionStartLabel: 'Upload',
+    addFilesLabel: 'Add files',
+    addFolderLabel: 'Add folder',
+    getActionCompleteMessage: (data) => {
+        const { counts } = data ?? {};
+        const { COMPLETE, FAILED, OVERWRITE_PREVENTED, CANCELED, TOTAL } = counts ?? {};
+        const hasPreventedOverwrite = !!OVERWRITE_PREVENTED;
+        const hasFailure = !!FAILED;
+        const hasSuccess = !!COMPLETE;
+        const hasCanceled = !!CANCELED;
+        const type = hasFailure
+            ? 'error'
+            : hasPreventedOverwrite || hasCanceled
+                ? 'warning'
+                : 'success';
+        const preventedOverwriteMessage = hasPreventedOverwrite
+            ? [
+                'Overwrite prevented for',
+                OVERWRITE_PREVENTED === TOTAL ? 'all' : String(OVERWRITE_PREVENTED),
+                OVERWRITE_PREVENTED > 1 || OVERWRITE_PREVENTED === TOTAL
+                    ? `files`
+                    : 'file',
+            ].join(' ')
+            : undefined;
+        const canceledMessage = hasCanceled
+            ? [
+                CANCELED === TOTAL ? 'All' : String(CANCELED),
+                CANCELED > 1 || CANCELED === TOTAL ? `uploads` : 'upload',
+                'canceled',
+            ].join(' ')
+            : undefined;
+        const failedMessage = hasFailure
+            ? [
+                FAILED === TOTAL ? 'All' : String(FAILED),
+                FAILED > 1 || FAILED === TOTAL ? `files` : 'file',
+                'failed to upload',
+            ].join(' ')
+            : undefined;
+        const completedMessage = hasSuccess
+            ? [
+                COMPLETE === TOTAL ? 'All' : String(COMPLETE),
+                COMPLETE > 1 || COMPLETE === TOTAL ? `files` : 'file',
+                'uploaded',
+            ].join(' ')
+            : undefined;
+        const messages = [
+            preventedOverwriteMessage,
+            failedMessage,
+            canceledMessage,
+            completedMessage,
+        ].filter(Boolean);
+        if (messages.length > 0) {
+            return {
+                content: messages.join(', ') + '.',
+                type,
+            };
+        }
+        return { content: 'All files uploaded.', type };
+    },
+    getFilesValidationMessage: (data) => {
+        if (!data?.invalidFiles) {
+            return undefined;
+        }
+        const tooBigFileNames = data.invalidFiles
+            .filter(({ file }) => isFileTooBig(file))
+            .map(({ file }) => file.name)
+            .join(', ');
+        if (tooBigFileNames) {
+            return {
+                content: `Files larger than 160GB cannot be added to the upload queue: ${tooBigFileNames}`,
+                type: 'warning',
+            };
+        }
+        return undefined;
+    },
+    statusDisplayOverwritePreventedLabel: 'Overwrite prevented',
+    overwriteToggleLabel: 'Overwrite existing files',
+};
+
+export { DEFAULT_UPLOAD_VIEW_DISPLAY_TEXT };

package/dist/esm/components/StorageBrowser/providers/configuration/context.mjs

@@ -0,0 +1,19 @@
+import React__default from 'react';
+import { createContextUtilities } from '@aws-amplify/ui-react-core';
+import { useGetActionInputCallback } from './useGetActionInputCallback.mjs';
+
+const ERROR_MESSAGE = '`useGetActionInput` must be called from within a `ConfigurationProvider`.';
+const { useGetActionInput, GetActionInputContext } = createContextUtilities({
+    contextName: 'GetActionInput',
+    errorMessage: ERROR_MESSAGE,
+});
+function GetActionInputProvider({ accountId, children, customEndpoint, region, }) {
+    const value = useGetActionInputCallback({
+        accountId,
+        customEndpoint,
+        region,
+    });
+    return (React__default.createElement(GetActionInputContext.Provider, { value: value }, children));
+}
+
+export { GetActionInputContext, GetActionInputProvider, useGetActionInput };

package/dist/esm/components/StorageBrowser/providers/configuration/createConfigurationProvider.mjs

@@ -0,0 +1,23 @@
+import React__default from 'react';
+import { isComponent } from '@aws-amplify/ui-react-core/elements';
+import { ActionConfigsProvider } from '../../actions/configs/context.mjs';
+import '@aws-amplify/storage/internals';
+import '@aws-amplify/ui';
+import 'aws-amplify/storage';
+import '@aws-amplify/ui-react-core';
+import { CredentialsProvider } from './credentials/context.mjs';
+import { GetActionInputProvider } from './context.mjs';
+
+const Passthrough = ({ children }) => (React__default.createElement(React__default.Fragment, null, children));
+function createConfigurationProvider(input) {
+    const { accountId, actions, ChildComponent, displayName, region, customEndpoint, ...rest } = input;
+    const Child = isComponent(ChildComponent) ? ChildComponent : Passthrough;
+    const Provider = (props) => (React__default.createElement(ActionConfigsProvider, { actions: actions },
+        React__default.createElement(CredentialsProvider, { ...rest },
+            React__default.createElement(GetActionInputProvider, { accountId: accountId, region: region, customEndpoint: customEndpoint },
+                React__default.createElement(Child, { ...props })))));
+    Provider.displayName = displayName;
+    return Provider;
+}
+
+export { createConfigurationProvider };

package/dist/esm/components/StorageBrowser/providers/configuration/credentials/context.mjs

@@ -0,0 +1,16 @@
+import React__default from 'react';
+import { createContextUtilities } from '@aws-amplify/ui-react-core';
+import { useCredentialsStore } from './useCredentialsStore.mjs';
+
+const ERROR_MESSAGE = '`useCredentials` must be called from within a `CredentialsProvider`.';
+const { useCredentials, CredentialsContext } = createContextUtilities({
+    contextName: 'Credentials',
+    errorMessage: ERROR_MESSAGE,
+});
+function CredentialsProvider({ children, ...props }) {
+    const initialValue = React__default.useContext(CredentialsContext);
+    const value = useCredentialsStore({ ...props, initialValue });
+    return (React__default.createElement(CredentialsContext.Provider, { value: value }, children));
+}
+
+export { CredentialsContext, CredentialsProvider, useCredentials };

package/dist/esm/components/StorageBrowser/providers/configuration/credentials/useCredentialsStore.mjs

@@ -0,0 +1,37 @@
+import React__default from 'react';
+import { isFunction } from '@aws-amplify/ui';
+import { createLocationCredentialsStore } from '../../../credentials/store/create.mjs';
+
+const createCredentialsStore = ({ ...input }) => {
+    const { destroy, getProvider } = createLocationCredentialsStore(input);
+    return {
+        destroy,
+        getCredentials: ({ scope, permissions }) => getProvider({
+            scope,
+            permissions,
+        }),
+    };
+};
+const isCredentialsStore = (value) => isFunction(value?.getCredentials);
+function useCredentialsStore({ getLocationCredentials: handler, initialValue, onDestroy, registerAuthListener, }) {
+    const hasExistingStore = isCredentialsStore(initialValue);
+    const [store, setStore] = React__default.useState(() => hasExistingStore ? initialValue : createCredentialsStore({ handler }));
+    const { destroy } = store;
+    React__default.useEffect(() => {
+        if (hasExistingStore) {
+            return;
+        }
+        const handleAuthStatusChange = () => {
+            destroy();
+            if (isFunction(onDestroy)) {
+                onDestroy();
+            }
+            setStore(createCredentialsStore({ handler }));
+        };
+        // provide `handleAuthStatusChange` to consumer
+        registerAuthListener(handleAuthStatusChange);
+    }, [destroy, handler, hasExistingStore, onDestroy, registerAuthListener]);
+    return store;
+}
+
+export { useCredentialsStore };

package/dist/esm/components/StorageBrowser/providers/configuration/useGetActionInputCallback.mjs

@@ -0,0 +1,41 @@
+import React__default from 'react';
+import { assertLocationData, assertPrefix } from '../../validators/assertLocationData.mjs';
+import '@aws-amplify/ui';
+import '../store/location/context.mjs';
+import '../store/files/context.mjs';
+import '../store/actionType/context.mjs';
+import '../store/locationItems/context.mjs';
+import { useStore } from '../store/useStore.mjs';
+import { useCredentials } from './credentials/context.mjs';
+
+const getErrorMessage = (propertyName) => `Unable to resolve credentials due to invalid value of '${propertyName}'`;
+function useGetActionInputCallback({ accountId, customEndpoint, region, }) {
+    const { getCredentials } = useCredentials();
+    const [{ location }] = useStore();
+    const { current, key } = location;
+    return React__default.useCallback((location) => {
+        // prefer passed in location / prefix over current location in state
+        const _location = location ?? current;
+        // when `location` has been provided as a param, resolve `_prefix` to `location.prefix`.
+        // in the default scenario where `current` is the target `location` use the fully qualified `key`
+        // that includes the default `prefix` and any additional prefixes from navigation
+        const _prefix = location ? location.prefix : key;
+        assertLocationData(_location, getErrorMessage('locationData'));
+        assertPrefix(_prefix, getErrorMessage('prefix'));
+        const { bucket, permissions, type } = _location;
+        // BUCKET/PREFIX grants end with `*`, but object grants do not.
+        const scope = `s3://${bucket}/${_prefix}${type === 'OBJECT' ? '' : '*'}`;
+        return {
+            accountId,
+            bucket,
+            credentials: getCredentials({
+                permissions,
+                scope,
+            }),
+            region,
+            customEndpoint,
+        };
+    }, [accountId, current, customEndpoint, getCredentials, key, region]);
+}
+
+export { getErrorMessage, useGetActionInputCallback };

package/dist/esm/components/StorageBrowser/providers/store/StoreProvider.mjs

@@ -0,0 +1,15 @@
+import React__default from 'react';
+import { LocationProvider } from './location/context.mjs';
+import { FilesProvider } from './files/context.mjs';
+import { ActionTypeProvider } from './actionType/context.mjs';
+import { LocationItemsProvider } from './locationItems/context.mjs';
+
+function StoreProvider(props) {
+    const { actionType, children, location, path } = props;
+    return (React__default.createElement(FilesProvider, null,
+        React__default.createElement(LocationProvider, { location: location, path: path },
+            React__default.createElement(LocationItemsProvider, null,
+                React__default.createElement(ActionTypeProvider, { actionType: actionType }, children)))));
+}
+
+export { StoreProvider };

package/dist/esm/components/StorageBrowser/providers/store/actionType/context.mjs

@@ -0,0 +1,16 @@
+import React__default from 'react';
+import { createContextUtilities } from '@aws-amplify/ui-react-core';
+import { noop } from '@aws-amplify/ui';
+import { useActionTypeState } from './useActionTypeState.mjs';
+
+const defaultValue = [undefined, noop];
+const { ActionTypeContext, useActionType } = createContextUtilities({
+    contextName: 'ActionType',
+    defaultValue,
+});
+function ActionTypeProvider({ actionType, children, }) {
+    const value = useActionTypeState(actionType);
+    return (React__default.createElement(ActionTypeContext.Provider, { value: value }, children));
+}
+
+export { ActionTypeContext, ActionTypeProvider, useActionType };

package/dist/esm/components/StorageBrowser/providers/store/actionType/useActionTypeState.mjs

@@ -0,0 +1,19 @@
+import React__default from 'react';
+
+const handleAction = (event) => {
+    switch (event.type) {
+        case 'SET_ACTION_TYPE': {
+            return event.actionType;
+        }
+        case 'RESET_ACTION_TYPE': {
+            return undefined;
+        }
+    }
+};
+function useActionTypeState(initialState) {
+    const [actionType, setActionType] = React__default.useState(initialState);
+    const handler = React__default.useCallback((action) => setActionType(handleAction(action)), []);
+    return [actionType, handler];
+}
+
+export { useActionTypeState };

package/dist/esm/components/StorageBrowser/providers/store/files/context.mjs

@@ -0,0 +1,31 @@
+import React__default from 'react';
+import { noop } from '@aws-amplify/ui';
+import { createContextUtilities } from '@aws-amplify/ui-react-core';
+import { useFileSelect } from '@aws-amplify/ui-react/internal';
+import { filesReducer, parseFileSelectParams } from './utils.mjs';
+
+const defaultValue = [undefined, noop];
+const { FilesContext, useFiles } = createContextUtilities({
+    contextName: 'Files',
+    defaultValue,
+});
+function FilesProvider({ children, }) {
+    const [items, dispatch] = React__default.useReducer(filesReducer, []);
+    const [fileInput, handleFileSelect] = useFileSelect((nextFiles) => {
+        dispatch({ type: 'ADD_FILE_ITEMS', files: nextFiles });
+    });
+    const handleFilesAction = React__default.useCallback((action) => {
+        if (action.type === 'SELECT_FILES') {
+            handleFileSelect(...parseFileSelectParams(action.selectionType));
+        }
+        else {
+            dispatch(action);
+        }
+    }, [handleFileSelect]);
+    const value = React__default.useMemo(() => [items, handleFilesAction], [items, handleFilesAction]);
+    return (React__default.createElement(FilesContext.Provider, { value: value },
+        fileInput,
+        children));
+}
+
+export { FilesContext, FilesProvider, useFiles };

package/dist/esm/components/StorageBrowser/providers/store/files/utils.mjs

@@ -0,0 +1,52 @@
+import { isUndefined, isString, isEmpty } from '@aws-amplify/ui';
+
+const compareFileItems = (prev, next) => prev.key.localeCompare(next.key);
+const resolveFiles = (prevItems, files) => {
+    if (!files?.length)
+        return prevItems;
+    // construct `nextItems` and filter out existing `file` entries
+    const nextItems = files.reduce((items, file) => {
+        const { name, webkitRelativePath } = file;
+        return prevItems.some(({ file: existing }) => existing.name === name &&
+            existing.webkitRelativePath === webkitRelativePath)
+            ? items
+            : items.concat({
+                key: isEmpty(webkitRelativePath) ? name : webkitRelativePath,
+                id: crypto.randomUUID(),
+                file,
+            });
+    }, []);
+    if (!nextItems.length)
+        return prevItems;
+    if (!prevItems.length) {
+        return nextItems.sort(compareFileItems);
+    }
+    return prevItems.concat(nextItems).sort(compareFileItems);
+};
+const filesReducer = (prevItems, input) => {
+    switch (input.type) {
+        case 'ADD_FILE_ITEMS': {
+            return resolveFiles(prevItems, input.files);
+        }
+        case 'REMOVE_FILE_ITEM': {
+            const filteredItems = prevItems.filter(({ id }) => id !== input.id);
+            return filteredItems.length === prevItems.length
+                ? prevItems
+                : filteredItems;
+        }
+        case 'RESET_FILE_ITEMS': {
+            return [];
+        }
+        // TODO: clear message
+    }
+};
+const parseFileSelectParams = (value) => {
+    if (isUndefined(value))
+        return ['FILE', undefined];
+    if (isString(value))
+        return [value, undefined];
+    const [selectType, ...rest] = value;
+    return [selectType, !rest?.length ? undefined : { accept: rest.join() }];
+};
+
+export { filesReducer, parseFileSelectParams, resolveFiles };