@aws-amplify/storage 6.6.0 → 6.6.1-storage-browser.37d5283.0

package/dist/esm/storageBrowser/locationCredentialsStore/store.mjs

@@ -0,0 +1,95 @@
+import { assertValidationError } from '../../errors/utils/assertValidationError.mjs';
+import { StorageValidationErrorCode } from '../../errors/types/validation.mjs';
+import { CREDENTIALS_STORE_DEFAULT_SIZE, CREDENTIALS_REFRESH_WINDOW_MS } from './constants.mjs';
+
+/* eslint-disable unused-imports/no-unused-vars */
+const createCacheKey = (location) => `${location.scope}_${location.permission}`;
+/**
+ * @internal
+ */
+const initStore = (refreshHandler, size = CREDENTIALS_STORE_DEFAULT_SIZE) => {
+    assertValidationError(size > 0, StorageValidationErrorCode.InvalidLocationCredentialsCacheSize);
+    return {
+        capacity: size,
+        refreshHandler,
+        values: new Map(),
+    };
+};
+const getCacheValue = (store, location) => {
+    const cacheKey = createCacheKey(location);
+    const cachedValue = store.values.get(cacheKey);
+    const cachedCredentials = cachedValue?.credentials;
+    if (!cachedCredentials) {
+        return null;
+    }
+    // Delete and re-insert to key to map to indicate a latest reference in LRU.
+    store.values.delete(cacheKey);
+    if (!pastTTL(cachedCredentials)) {
+        // TODO(@AllanZhengYP): If the credential is still valid but will expire
+        // soon, we should return credentials AND dispatch a refresh.
+        store.values.set(cacheKey, cachedValue);
+        return cachedCredentials;
+    }
+    return null;
+};
+const pastTTL = (credentials) => {
+    const { expiration } = credentials;
+    return expiration.getTime() - CREDENTIALS_REFRESH_WINDOW_MS <= Date.now();
+};
+/**
+ * Fetch new credentials value with refresh handler and cache the result in
+ * LRU cache.
+ * @internal
+ */
+const fetchNewValue = async (store, location) => {
+    const storeValues = store.values;
+    const key = createCacheKey(location);
+    if (!storeValues.has(key)) {
+        const newStoreValue = {
+            scope: location.scope,
+            permission: location.permission,
+        };
+        setCacheRecord(store, key, newStoreValue);
+    }
+    const storeValue = storeValues.get(key);
+    return dispatchRefresh(store.refreshHandler, storeValue, () => {
+        store.values.delete(key);
+    });
+};
+const dispatchRefresh = (refreshHandler, value, onRefreshFailure) => {
+    if (value.inflightCredentials) {
+        return value.inflightCredentials;
+    }
+    value.inflightCredentials = (async () => {
+        try {
+            const { credentials } = await refreshHandler({
+                scope: value.scope,
+                permission: value.permission,
+            });
+            value.credentials = credentials;
+            return { credentials };
+        }
+        catch (e) {
+            onRefreshFailure();
+            throw e;
+        }
+        finally {
+            value.inflightCredentials = undefined;
+        }
+    })();
+    return value.inflightCredentials;
+};
+const setCacheRecord = (store, key, value) => {
+    if (store.capacity === store.values.size) {
+        // Pop least used entry. The Map's key are in insertion order.
+        // So first key is the last recently inserted.
+        const [oldestKey] = store.values.keys();
+        store.values.delete(oldestKey);
+        // TODO(@AllanZhengYP): Add log info when record is evicted.
+    }
+    // Add latest used value to the cache.
+    store.values.set(key, value);
+};
+
+export { fetchNewValue, getCacheValue, initStore };
+//# sourceMappingURL=store.mjs.map

package/dist/esm/storageBrowser/locationCredentialsStore/store.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.mjs","sources":["../../../../src/storageBrowser/locationCredentialsStore/store.ts"],"sourcesContent":["/* eslint-disable unused-imports/no-unused-vars */\nimport { assertValidationError } from '../../errors/utils/assertValidationError';\nimport { StorageValidationErrorCode } from '../../errors/types/validation';\nimport { CREDENTIALS_REFRESH_WINDOW_MS, CREDENTIALS_STORE_DEFAULT_SIZE, } from './constants';\nconst createCacheKey = (location) => `${location.scope}_${location.permission}`;\n/**\n * @internal\n */\nexport const initStore = (refreshHandler, size = CREDENTIALS_STORE_DEFAULT_SIZE) => {\n    assertValidationError(size > 0, StorageValidationErrorCode.InvalidLocationCredentialsCacheSize);\n    return {\n        capacity: size,\n        refreshHandler,\n        values: new Map(),\n    };\n};\nexport const getCacheValue = (store, location) => {\n    const cacheKey = createCacheKey(location);\n    const cachedValue = store.values.get(cacheKey);\n    const cachedCredentials = cachedValue?.credentials;\n    if (!cachedCredentials) {\n        return null;\n    }\n    // Delete and re-insert to key to map to indicate a latest reference in LRU.\n    store.values.delete(cacheKey);\n    if (!pastTTL(cachedCredentials)) {\n        // TODO(@AllanZhengYP): If the credential is still valid but will expire\n        // soon, we should return credentials AND dispatch a refresh.\n        store.values.set(cacheKey, cachedValue);\n        return cachedCredentials;\n    }\n    return null;\n};\nconst pastTTL = (credentials) => {\n    const { expiration } = credentials;\n    return expiration.getTime() - CREDENTIALS_REFRESH_WINDOW_MS <= Date.now();\n};\n/**\n * Fetch new credentials value with refresh handler and cache the result in\n * LRU cache.\n * @internal\n */\nexport const fetchNewValue = async (store, location) => {\n    const storeValues = store.values;\n    const key = createCacheKey(location);\n    if (!storeValues.has(key)) {\n        const newStoreValue = {\n            scope: location.scope,\n            permission: location.permission,\n        };\n        setCacheRecord(store, key, newStoreValue);\n    }\n    const storeValue = storeValues.get(key);\n    return dispatchRefresh(store.refreshHandler, storeValue, () => {\n        store.values.delete(key);\n    });\n};\nconst dispatchRefresh = (refreshHandler, value, onRefreshFailure) => {\n    if (value.inflightCredentials) {\n        return value.inflightCredentials;\n    }\n    value.inflightCredentials = (async () => {\n        try {\n            const { credentials } = await refreshHandler({\n                scope: value.scope,\n                permission: value.permission,\n            });\n            value.credentials = credentials;\n            return { credentials };\n        }\n        catch (e) {\n            onRefreshFailure();\n            throw e;\n        }\n        finally {\n            value.inflightCredentials = undefined;\n        }\n    })();\n    return value.inflightCredentials;\n};\nconst setCacheRecord = (store, key, value) => {\n    if (store.capacity === store.values.size) {\n        // Pop least used entry. The Map's key are in insertion order.\n        // So first key is the last recently inserted.\n        const [oldestKey] = store.values.keys();\n        store.values.delete(oldestKey);\n        // TODO(@AllanZhengYP): Add log info when record is evicted.\n    }\n    // Add latest used value to the cache.\n    store.values.set(key, value);\n};\n"],"names":[],"mappings":"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"}

package/dist/esm/storageBrowser/managedAuthConfigAdapter/createListLocationsHandler.d.ts

@@ -0,0 +1,8 @@
+import { CredentialsProvider, ListLocations } from '../types';
+interface CreateListLocationsHandlerInput {
+    accountId: string;
+    credentialsProvider: CredentialsProvider;
+    region: string;
+}
+export declare const createListLocationsHandler: (handlerInput: CreateListLocationsHandlerInput) => ListLocations;
+export {};

package/dist/esm/storageBrowser/managedAuthConfigAdapter/createListLocationsHandler.mjs

@@ -0,0 +1,13 @@
+import { listCallerAccessGrants } from '../apis/listCallerAccessGrants.mjs';
+
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+const createListLocationsHandler = (handlerInput) => {
+    return async function listLocations(input = {}) {
+        const result = await listCallerAccessGrants({ ...input, ...handlerInput });
+        return result;
+    };
+};
+
+export { createListLocationsHandler };
+//# sourceMappingURL=createListLocationsHandler.mjs.map

package/dist/esm/storageBrowser/managedAuthConfigAdapter/createListLocationsHandler.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createListLocationsHandler.mjs","sources":["../../../../src/storageBrowser/managedAuthConfigAdapter/createListLocationsHandler.ts"],"sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\nimport { listCallerAccessGrants } from '../apis/listCallerAccessGrants';\nexport const createListLocationsHandler = (handlerInput) => {\n    return async function listLocations(input = {}) {\n        const result = await listCallerAccessGrants({ ...input, ...handlerInput });\n        return result;\n    };\n};\n"],"names":[],"mappings":";;AAAA;AACA;AAEY,MAAC,0BAA0B,GAAG,CAAC,YAAY,KAAK;AAC5D,IAAI,OAAO,eAAe,aAAa,CAAC,KAAK,GAAG,EAAE,EAAE;AACpD,QAAQ,MAAM,MAAM,GAAG,MAAM,sBAAsB,CAAC,EAAE,GAAG,KAAK,EAAE,GAAG,YAAY,EAAE,CAAC,CAAC;AACnF,QAAQ,OAAO,MAAM,CAAC;AACtB,KAAK,CAAC;AACN;;;;"}

package/dist/esm/storageBrowser/managedAuthConfigAdapter/createLocationCredentialsHandler.d.ts

@@ -0,0 +1,8 @@
+import { CredentialsProvider, GetLocationCredentials } from '../types';
+interface CreateLocationCredentialsHandlerInput {
+    accountId: string;
+    credentialsProvider: CredentialsProvider;
+    region: string;
+}
+export declare const createLocationCredentialsHandler: (handlerInput: CreateLocationCredentialsHandlerInput) => GetLocationCredentials;
+export {};

package/dist/esm/storageBrowser/managedAuthConfigAdapter/createLocationCredentialsHandler.mjs

@@ -0,0 +1,27 @@
+import { getDataAccess } from '../apis/getDataAccess.mjs';
+
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+const createLocationCredentialsHandler = (handlerInput) => {
+    const { accountId, region, credentialsProvider } = handlerInput;
+    /**
+     * Retrieves credentials for the specified scope & permission.
+     *
+     * @param input - An object specifying the requested scope & permission.
+     *
+     * @returns A promise which will resolve with the requested credentials.
+     */
+    return (input) => {
+        const { scope, permission } = input;
+        return getDataAccess({
+            accountId,
+            credentialsProvider,
+            permission,
+            region,
+            scope,
+        });
+    };
+};
+
+export { createLocationCredentialsHandler };
+//# sourceMappingURL=createLocationCredentialsHandler.mjs.map

package/dist/esm/storageBrowser/managedAuthConfigAdapter/createLocationCredentialsHandler.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createLocationCredentialsHandler.mjs","sources":["../../../../src/storageBrowser/managedAuthConfigAdapter/createLocationCredentialsHandler.ts"],"sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\nimport { getDataAccess } from '../apis/getDataAccess';\nexport const createLocationCredentialsHandler = (handlerInput) => {\n    const { accountId, region, credentialsProvider } = handlerInput;\n    /**\n     * Retrieves credentials for the specified scope & permission.\n     *\n     * @param input - An object specifying the requested scope & permission.\n     *\n     * @returns A promise which will resolve with the requested credentials.\n     */\n    return (input) => {\n        const { scope, permission } = input;\n        return getDataAccess({\n            accountId,\n            credentialsProvider,\n            permission,\n            region,\n            scope,\n        });\n    };\n};\n"],"names":[],"mappings":";;AAAA;AACA;AAEY,MAAC,gCAAgC,GAAG,CAAC,YAAY,KAAK;AAClE,IAAI,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,mBAAmB,EAAE,GAAG,YAAY,CAAC;AACpE;AACA;AACA;AACA;AACA;AACA;AACA;AACA,IAAI,OAAO,CAAC,KAAK,KAAK;AACtB,QAAQ,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC;AAC5C,QAAQ,OAAO,aAAa,CAAC;AAC7B,YAAY,SAAS;AACrB,YAAY,mBAAmB;AAC/B,YAAY,UAAU;AACtB,YAAY,MAAM;AAClB,YAAY,KAAK;AACjB,SAAS,CAAC,CAAC;AACX,KAAK,CAAC;AACN;;;;"}

package/dist/esm/storageBrowser/managedAuthConfigAdapter/createManagedAuthConfigAdapter.d.ts

@@ -0,0 +1,19 @@
+import { CredentialsProvider, GetLocationCredentials, ListLocations } from '../types';
+export interface CreateManagedAuthConfigAdapterInput {
+    accountId: string;
+    region: string;
+    credentialsProvider: CredentialsProvider;
+}
+export interface AuthConfigAdapter {
+    listLocations: ListLocations;
+    getLocationCredentials: GetLocationCredentials;
+    region: string;
+}
+/**
+ * Create configuration including handlers to call S3 Access Grant APIs to list and get
+ * credentials for different locations.
+ *
+ * @param options - Configuration options for the adapter.
+ * @returns - An object containing the handlers to call S3 Access Grant APIs and region
+ */
+export declare const createManagedAuthConfigAdapter: ({ credentialsProvider, region, accountId, }: CreateManagedAuthConfigAdapterInput) => AuthConfigAdapter;

package/dist/esm/storageBrowser/managedAuthConfigAdapter/createManagedAuthConfigAdapter.mjs

@@ -0,0 +1,30 @@
+import { createListLocationsHandler } from './createListLocationsHandler.mjs';
+import { createLocationCredentialsHandler } from './createLocationCredentialsHandler.mjs';
+
+/**
+ * Create configuration including handlers to call S3 Access Grant APIs to list and get
+ * credentials for different locations.
+ *
+ * @param options - Configuration options for the adapter.
+ * @returns - An object containing the handlers to call S3 Access Grant APIs and region
+ */
+const createManagedAuthConfigAdapter = ({ credentialsProvider, region, accountId, }) => {
+    const listLocations = createListLocationsHandler({
+        credentialsProvider,
+        accountId,
+        region,
+    });
+    const getLocationCredentials = createLocationCredentialsHandler({
+        credentialsProvider,
+        accountId,
+        region,
+    });
+    return {
+        listLocations,
+        getLocationCredentials,
+        region,
+    };
+};
+
+export { createManagedAuthConfigAdapter };
+//# sourceMappingURL=createManagedAuthConfigAdapter.mjs.map

package/dist/esm/storageBrowser/managedAuthConfigAdapter/createManagedAuthConfigAdapter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"createManagedAuthConfigAdapter.mjs","sources":["../../../../src/storageBrowser/managedAuthConfigAdapter/createManagedAuthConfigAdapter.ts"],"sourcesContent":["import { createListLocationsHandler } from './createListLocationsHandler';\nimport { createLocationCredentialsHandler } from './createLocationCredentialsHandler';\n/**\n * Create configuration including handlers to call S3 Access Grant APIs to list and get\n * credentials for different locations.\n *\n * @param options - Configuration options for the adapter.\n * @returns - An object containing the handlers to call S3 Access Grant APIs and region\n */\nexport const createManagedAuthConfigAdapter = ({ credentialsProvider, region, accountId, }) => {\n    const listLocations = createListLocationsHandler({\n        credentialsProvider,\n        accountId,\n        region,\n    });\n    const getLocationCredentials = createLocationCredentialsHandler({\n        credentialsProvider,\n        accountId,\n        region,\n    });\n    return {\n        listLocations,\n        getLocationCredentials,\n        region,\n    };\n};\n"],"names":[],"mappings":";;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,8BAA8B,GAAG,CAAC,EAAE,mBAAmB,EAAE,MAAM,EAAE,SAAS,GAAG,KAAK;AAC/F,IAAI,MAAM,aAAa,GAAG,0BAA0B,CAAC;AACrD,QAAQ,mBAAmB;AAC3B,QAAQ,SAAS;AACjB,QAAQ,MAAM;AACd,KAAK,CAAC,CAAC;AACP,IAAI,MAAM,sBAAsB,GAAG,gCAAgC,CAAC;AACpE,QAAQ,mBAAmB;AAC3B,QAAQ,SAAS;AACjB,QAAQ,MAAM;AACd,KAAK,CAAC,CAAC;AACP,IAAI,OAAO;AACX,QAAQ,aAAa;AACrB,QAAQ,sBAAsB;AAC9B,QAAQ,MAAM;AACd,KAAK,CAAC;AACN;;;;"}

package/dist/esm/storageBrowser/managedAuthConfigAdapter/index.d.ts

@@ -0,0 +1 @@
+export { AuthConfigAdapter, createManagedAuthConfigAdapter, CreateManagedAuthConfigAdapterInput, } from './createManagedAuthConfigAdapter';

package/dist/esm/storageBrowser/managedAuthConfigAdapter/index.mjs

@@ -0,0 +1,2 @@
+export { createManagedAuthConfigAdapter } from './createManagedAuthConfigAdapter.mjs';
+//# sourceMappingURL=index.mjs.map

package/dist/esm/storageBrowser/managedAuthConfigAdapter/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/esm/storageBrowser/types.d.ts

@@ -0,0 +1,92 @@
+import { AWSTemporaryCredentials, LocationCredentialsProvider } from '../providers/s3/types/options';
+/**
+ * @internal
+ */
+export type Permission = 'READ' | 'READWRITE' | 'WRITE';
+/**
+ * @internal
+ */
+export type CredentialsProvider = LocationCredentialsProvider;
+/**
+ * @internal
+ */
+export type LocationType = 'BUCKET' | 'PREFIX' | 'OBJECT';
+/**
+ * @internal
+ */
+export type Privilege = 'Default' | 'Minimal';
+/**
+ * @internal
+ */
+export type PrefixType = 'Object';
+export interface LocationScope {
+    /**
+     * Scope of storage location. For S3 service, it's the S3 path of the data to
+     * which the access is granted. It can be in following formats:
+     *
+     * @example Bucket 's3://<bucket>/*'
+     * @example Prefix 's3://<bucket>/<prefix-with-path>*'
+     * @example Object 's3://<bucket>/<prefix-with-path>/<object>'
+     */
+    readonly scope: string;
+}
+export interface CredentialsLocation extends LocationScope {
+    /**
+     * The type of access granted to your Storage data. Can be either of READ,
+     * WRITE or READWRITE
+     */
+    readonly permission: Permission;
+}
+/**
+ * @internal
+ */
+export interface LocationAccess extends CredentialsLocation {
+    /**
+     * Parse location type parsed from scope format:
+     * * BUCKET: `'s3://<bucket>/*'`
+     * * PREFIX: `'s3://<bucket>/<prefix-with-path>*'`
+     * * OBJECT: `'s3://<bucket>/<prefix-with-path>/<object>'`
+     */
+    readonly type: LocationType;
+}
+export interface LocationCredentials extends Partial<LocationScope> {
+    /**
+     * AWS credentials which can be used to access the specified location.
+     */
+    readonly credentials: AWSTemporaryCredentials;
+}
+/**
+ * @internal
+ */
+export interface ListLocationsInput {
+    pageSize?: number;
+    nextToken?: string;
+}
+/**
+ * @internal
+ */
+export interface ListLocationsOutput {
+    locations: LocationAccess[];
+    nextToken?: string;
+}
+export type ListLocations = (input?: ListLocationsInput) => Promise<ListLocationsOutput>;
+export type GetLocationCredentialsInput = CredentialsLocation;
+export type GetLocationCredentialsOutput = LocationCredentials;
+export type GetLocationCredentials = (input: GetLocationCredentialsInput) => Promise<GetLocationCredentialsOutput>;
+export interface CreateLocationCredentialsStoreInput {
+    handler: GetLocationCredentials;
+}
+export interface LocationCredentialsStore {
+    /**
+     * Get location-specific credentials. It uses a cache internally to optimize performance when
+     * getting credentials for the same location. It will refresh credentials if they expire or
+     * when forced to.
+     */
+    getProvider(option: CredentialsLocation): LocationCredentialsProvider;
+    /**
+     * Invalidate cached credentials and force subsequent calls to get location-specific
+     * credentials to throw. It also makes subsequent calls to `getCredentialsProviderForLocation`
+     * to throw.
+     */
+    destroy(): void;
+}

package/dist/esm/storageBrowser/types.mjs

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=types.mjs.map

package/dist/esm/storageBrowser/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","sources":[],"sourcesContent":[],"names":[],"mappings":""}

package/dist/esm/types/inputs.d.ts

@@ -42,9 +42,9 @@ export interface StorageCopyInputWithKey<SourceOptions extends StorageOptions, D
     source: SourceOptions;
     destination: DestinationOptions;
 }
-export interface StorageCopyInputWithPath {
-    source: StorageOperationInputWithPath;
-    destination: StorageOperationInputWithPath;
+export interface StorageCopyInputWithPath<SourceOptions, DestinationOptions, Options = unknown> extends StorageOperationOptionsInput<Options> {
+    source: StorageOperationInputWithPath & SourceOptions;
+    destination: StorageOperationInputWithPath & DestinationOptions;
 }
 /**
  * The data payload type for upload operation.

package/package.json

@@ -1,109 +1,119 @@
 {
-	"name": "@aws-amplify/storage",
-	"version": "6.6.0",
-	"description": "Storage category of aws-amplify",
-	"main": "./dist/cjs/index.js",
-	"module": "./dist/esm/index.mjs",
-	"react-native": {
-		"./dist/cjs/index": "./src/index.ts",
-		"fast-xml-parser": "fast-xml-parser",
-		"buffer": "buffer"
-	},
-	"typings": "./dist/esm/index.d.ts",
-	"browser": {
-		"./dist/esm/providers/s3/utils/client/runtime/base64/index.native.mjs": "./dist/esm/providers/s3/utils/client/runtime/base64/index.browser.mjs",
-		"./dist/esm/providers/s3/utils/client/runtime/s3TransferHandler/fetch.mjs": "./dist/esm/providers/s3/utils/client/runtime/s3TransferHandler/xhr.mjs",
-		"./dist/esm/providers/s3/utils/client/runtime/xmlParser/pureJs.mjs": "./dist/esm/providers/s3/utils/client/runtime/xmlParser/dom.mjs",
-		"fast-xml-parser": false,
-		"buffer": false
-	},
-	"sideEffects": false,
-	"publishConfig": {
-		"access": "public"
-	},
-	"scripts": {
-		"test": "npm run lint && jest -w 1 --coverage --logHeapUsage",
-		"build-with-test": "npm test && npm run build",
-		"build:umd": "webpack && webpack --config ./webpack.config.dev.js",
-		"build:esm-cjs": "rollup --forceExit -c rollup.config.mjs",
-		"build:watch": "npm run build:esm-cjs -- --watch",
-		"build": "npm run clean && npm run build:esm-cjs && npm run build:umd",
-		"clean": "npm run clean:size && rimraf lib-esm lib dist",
-		"clean:size": "rimraf dual-publish-tmp tmp*",
-		"format": "echo \"Not implemented\"",
-		"lint": "eslint '**/*.{ts,tsx}' && npm run ts-coverage",
-		"lint:fix": "eslint '**/*.{ts,tsx}' --fix",
-		"ts-coverage": "typescript-coverage-report -p ./tsconfig.build.json -t 90.31"
-	},
-	"typesVersions": {
-		">=4.2": {
-			"s3": [
-				"./dist/esm/providers/s3/index.d.ts"
-			],
-			"server": [
-				"./dist/esm/server.d.ts"
-			],
-			"s3/server": [
-				"./dist/esm/providers/s3/server.d.ts"
-			]
-		}
-	},
-	"repository": {
-		"type": "git",
-		"url": "https://github.com/aws-amplify/amplify-js.git"
-	},
-	"author": "Amazon Web Services",
-	"license": "Apache-2.0",
-	"bugs": {
-		"url": "https://github.com/aws/aws-amplify/issues"
-	},
-	"homepage": "https://aws-amplify.github.io/",
-	"files": [
-		"dist/cjs",
-		"dist/esm",
-		"src",
-		"server",
-		"s3"
-	],
-	"dependencies": {
-		"@aws-sdk/types": "3.398.0",
-		"@smithy/md5-js": "2.0.7",
-		"buffer": "4.9.2",
-		"fast-xml-parser": "^4.4.1",
-		"tslib": "^2.5.0"
-	},
-	"exports": {
-		".": {
-			"types": "./dist/esm/index.d.ts",
-			"import": "./dist/esm/index.mjs",
-			"require": "./dist/cjs/index.js",
-			"react-native": "./src/index.ts"
-		},
-		"./server": {
-			"types": "./dist/esm/server.d.ts",
-			"import": "./dist/esm/server.mjs",
-			"require": "./dist/cjs/server.js"
-		},
-		"./s3": {
-			"types": "./dist/esm/providers/s3/index.d.ts",
-			"import": "./dist/esm/providers/s3/index.mjs",
-			"require": "./dist/cjs/providers/s3/index.js",
-			"react-native": "./src/providers/s3/index.ts"
-		},
-		"./s3/server": {
-			"types": "./dist/esm/providers/s3/server.d.ts",
-			"import": "./dist/esm/providers/s3/server.mjs",
-			"require": "./dist/cjs/providers/s3/server.js"
-		},
-		"./package.json": "./package.json"
-	},
-	"peerDependencies": {
-		"@aws-amplify/core": "^6.1.0"
-	},
-	"devDependencies": {
-		"@aws-amplify/core": "6.3.9",
-		"@aws-amplify/react-native": "1.1.4",
-		"typescript": "5.0.2"
-	},
-	"gitHead": "917ca35b6823bf4d02ef0202f3948d4a6477f734"
+  "name": "@aws-amplify/storage",
+  "version": "6.6.1-storage-browser.37d5283.0+37d5283",
+  "description": "Storage category of aws-amplify",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.mjs",
+  "react-native": {
+    "./dist/cjs/index": "./src/index.ts",
+    "fast-xml-parser": "fast-xml-parser",
+    "buffer": "buffer"
+  },
+  "typings": "./dist/esm/index.d.ts",
+  "browser": {
+    "./dist/esm/providers/s3/utils/client/runtime/base64/index.native.mjs": "./dist/esm/providers/s3/utils/client/runtime/base64/index.browser.mjs",
+    "./dist/esm/providers/s3/utils/client/runtime/s3TransferHandler/fetch.mjs": "./dist/esm/providers/s3/utils/client/runtime/s3TransferHandler/xhr.mjs",
+    "./dist/esm/providers/s3/utils/client/runtime/xmlParser/pureJs.mjs": "./dist/esm/providers/s3/utils/client/runtime/xmlParser/dom.mjs",
+    "fast-xml-parser": false,
+    "buffer": false
+  },
+  "sideEffects": false,
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "test": "npm run lint && jest -w 1 --coverage --logHeapUsage",
+    "build-with-test": "npm test && npm run build",
+    "build:umd": "webpack && webpack --config ./webpack.config.dev.js",
+    "build:esm-cjs": "rollup --forceExit -c rollup.config.mjs",
+    "build:watch": "npm run build:esm-cjs -- --watch",
+    "build": "npm run clean && npm run build:esm-cjs && npm run build:umd",
+    "clean": "npm run clean:size && rimraf lib-esm lib dist",
+    "clean:size": "rimraf dual-publish-tmp tmp*",
+    "format": "echo \"Not implemented\"",
+    "lint": "eslint '**/*.{ts,tsx}' && npm run ts-coverage",
+    "lint:fix": "eslint '**/*.{ts,tsx}' --fix",
+    "ts-coverage": "typescript-coverage-report -p ./tsconfig.build.json -t 90.31"
+  },
+  "typesVersions": {
+    ">=4.2": {
+      "s3": [
+        "./dist/esm/providers/s3/index.d.ts"
+      ],
+      "server": [
+        "./dist/esm/server.d.ts"
+      ],
+      "s3/server": [
+        "./dist/esm/providers/s3/server.d.ts"
+      ],
+      "storage-browser": [
+        "./dist/esm/storageBrowser/index.d.ts"
+      ]
+    }
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/aws-amplify/amplify-js.git"
+  },
+  "author": "Amazon Web Services",
+  "license": "Apache-2.0",
+  "bugs": {
+    "url": "https://github.com/aws/aws-amplify/issues"
+  },
+  "homepage": "https://aws-amplify.github.io/",
+  "files": [
+    "dist/cjs",
+    "dist/esm",
+    "src",
+    "server",
+    "s3"
+  ],
+  "dependencies": {
+    "@aws-sdk/types": "3.398.0",
+    "@smithy/md5-js": "2.0.7",
+    "buffer": "4.9.2",
+    "crc-32": "^1.2.2",
+    "fast-xml-parser": "^4.4.1",
+    "tslib": "^2.5.0"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/esm/index.d.ts",
+      "import": "./dist/esm/index.mjs",
+      "require": "./dist/cjs/index.js",
+      "react-native": "./src/index.ts"
+    },
+    "./server": {
+      "types": "./dist/esm/server.d.ts",
+      "import": "./dist/esm/server.mjs",
+      "require": "./dist/cjs/server.js"
+    },
+    "./s3": {
+      "types": "./dist/esm/providers/s3/index.d.ts",
+      "import": "./dist/esm/providers/s3/index.mjs",
+      "require": "./dist/cjs/providers/s3/index.js",
+      "react-native": "./src/providers/s3/index.ts"
+    },
+    "./s3/server": {
+      "types": "./dist/esm/providers/s3/server.d.ts",
+      "import": "./dist/esm/providers/s3/server.mjs",
+      "require": "./dist/cjs/providers/s3/server.js"
+    },
+    "./storage-browser": {
+      "types": "./dist/esm/storageBrowser/index.d.ts",
+      "import": "./dist/esm/storageBrowser/index.mjs",
+      "require": "./dist/cjs/storageBrowser/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "peerDependencies": {
+    "@aws-amplify/core": "6.3.10-storage-browser.37d5283.0+37d5283"
+  },
+  "devDependencies": {
+    "@aws-amplify/core": "6.3.10-storage-browser.37d5283.0+37d5283",
+    "@aws-amplify/react-native": "1.1.5-storage-browser.37d5283.0+37d5283",
+    "@types/node": "20.14.12",
+    "typescript": "5.0.2"
+  },
+  "gitHead": "37d52835589eb9903ea5c9ebf530e81e337ada3e"
 }

package/src/errors/constants.ts

@@ -0,0 +1,4 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+export const INVALID_STORAGE_INPUT = 'InvalidStorageInput';