@aws-amplify/storage 5.9.6-unstable.7762f1a.0 → 6.0.0

package/README.md

@@ -0,0 +1,3 @@
+> INTERNAL USE ONLY
+
+This package contains the AWS Amplify Storage category and is intended for internal use only. To integrate Amplify into your app, please use [aws-amplify](https://www.npmjs.com/package/aws-amplify).

package/lib/errors/CanceledError.d.ts

@@ -0,0 +1,16 @@
+import { AmplifyErrorParams } from '@aws-amplify/core/internals/utils';
+import { StorageError } from './StorageError';
+/**
+ * Internal-only class for CanceledError thrown by XHR handler or multipart upload when cancellation is invoked
+ * without overwriting behavior.
+ *
+ * @internal
+ */
+export declare class CanceledError extends StorageError {
+    constructor(params?: Partial<AmplifyErrorParams>);
+}
+/**
+ * Check if an error is caused by user calling `cancel()` on a upload/download task. If an overwriting error is
+ * supplied to `task.cancel(errorOverwrite)`, this function will return `false`.
+ */
+export declare const isCancelError: (error: unknown) => error is CanceledError;

package/lib/errors/CanceledError.js

@@ -0,0 +1,31 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isCancelError = exports.CanceledError = void 0;
+const StorageError_1 = require("./StorageError");
+/**
+ * Internal-only class for CanceledError thrown by XHR handler or multipart upload when cancellation is invoked
+ * without overwriting behavior.
+ *
+ * @internal
+ */
+class CanceledError extends StorageError_1.StorageError {
+    constructor(params = {}) {
+        super({
+            name: 'CanceledError',
+            message: 'Upload is canceled by user',
+            ...params,
+        });
+        // TODO: Delete the following 2 lines after we change the build target to >= es2015
+        this.constructor = CanceledError;
+        Object.setPrototypeOf(this, CanceledError.prototype);
+    }
+}
+exports.CanceledError = CanceledError;
+/**
+ * Check if an error is caused by user calling `cancel()` on a upload/download task. If an overwriting error is
+ * supplied to `task.cancel(errorOverwrite)`, this function will return `false`.
+ */
+const isCancelError = (error) => !!error && error instanceof CanceledError;
+exports.isCancelError = isCancelError;

package/lib/errors/StorageError.d.ts

@@ -0,0 +1,4 @@
+import { AmplifyError, AmplifyErrorParams } from '@aws-amplify/core/internals/utils';
+export declare class StorageError extends AmplifyError {
+    constructor(params: AmplifyErrorParams);
+}

package/lib/errors/StorageError.js

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StorageError = void 0;
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+const utils_1 = require("@aws-amplify/core/internals/utils");
+class StorageError extends utils_1.AmplifyError {
+    constructor(params) {
+        super(params);
+        // TODO: Delete the following 2 lines after we change the build target to >= es2015
+        this.constructor = StorageError;
+        Object.setPrototypeOf(this, StorageError.prototype);
+    }
+}
+exports.StorageError = StorageError;

package/lib/errors/types/validation.d.ts

@@ -0,0 +1,14 @@
+import { AmplifyErrorMap } from '@aws-amplify/core/internals/utils';
+export declare enum StorageValidationErrorCode {
+    NoCredentials = "NoCredentials",
+    NoIdentityId = "NoIdentityId",
+    NoKey = "NoKey",
+    NoSourceKey = "NoSourceKey",
+    NoDestinationKey = "NoDestinationKey",
+    NoBucket = "NoBucket",
+    NoRegion = "NoRegion",
+    UrlExpirationMaxLimitExceed = "UrlExpirationMaxLimitExceed",
+    ObjectIsTooLarge = "ObjectIsTooLarge",
+    InvalidUploadSource = "InvalidUploadSource"
+}
+export declare const validationErrorMap: AmplifyErrorMap<StorageValidationErrorCode>;

package/lib/errors/types/validation.js

@@ -0,0 +1,50 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validationErrorMap = exports.StorageValidationErrorCode = void 0;
+var StorageValidationErrorCode;
+(function (StorageValidationErrorCode) {
+    StorageValidationErrorCode["NoCredentials"] = "NoCredentials";
+    StorageValidationErrorCode["NoIdentityId"] = "NoIdentityId";
+    StorageValidationErrorCode["NoKey"] = "NoKey";
+    StorageValidationErrorCode["NoSourceKey"] = "NoSourceKey";
+    StorageValidationErrorCode["NoDestinationKey"] = "NoDestinationKey";
+    StorageValidationErrorCode["NoBucket"] = "NoBucket";
+    StorageValidationErrorCode["NoRegion"] = "NoRegion";
+    StorageValidationErrorCode["UrlExpirationMaxLimitExceed"] = "UrlExpirationMaxLimitExceed";
+    StorageValidationErrorCode["ObjectIsTooLarge"] = "ObjectIsTooLarge";
+    StorageValidationErrorCode["InvalidUploadSource"] = "InvalidUploadSource";
+})(StorageValidationErrorCode = exports.StorageValidationErrorCode || (exports.StorageValidationErrorCode = {}));
+exports.validationErrorMap = {
+    [StorageValidationErrorCode.NoCredentials]: {
+        message: 'Credentials should not be empty.',
+    },
+    [StorageValidationErrorCode.NoIdentityId]: {
+        message: 'Missing identity ID when accessing objects in protected or private access level.',
+    },
+    [StorageValidationErrorCode.NoKey]: {
+        message: 'Missing key in api call.',
+    },
+    [StorageValidationErrorCode.NoSourceKey]: {
+        message: 'Missing source key in copy api call.',
+    },
+    [StorageValidationErrorCode.NoDestinationKey]: {
+        message: 'Missing destination key in copy api call.',
+    },
+    [StorageValidationErrorCode.NoBucket]: {
+        message: 'Missing bucket name while accessing object.',
+    },
+    [StorageValidationErrorCode.NoRegion]: {
+        message: 'Missing region while accessing object.',
+    },
+    [StorageValidationErrorCode.UrlExpirationMaxLimitExceed]: {
+        message: 'Url Expiration can not be greater than 7 Days.',
+    },
+    [StorageValidationErrorCode.ObjectIsTooLarge]: {
+        message: 'Object size cannot not be greater than 5TB.',
+    },
+    [StorageValidationErrorCode.InvalidUploadSource]: {
+        message: 'Upload source type can only be a `Blob`, `File`, `ArrayBuffer`, or `string`.',
+    },
+};

package/lib/errors/utils/assertValidationError.d.ts

@@ -0,0 +1,2 @@
+import { StorageValidationErrorCode } from '../types/validation';
+export declare function assertValidationError(assertion: boolean, name: StorageValidationErrorCode): asserts assertion;

package/lib/errors/utils/assertValidationError.js

@@ -0,0 +1,14 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.assertValidationError = void 0;
+const validation_1 = require("../types/validation");
+const StorageError_1 = require("../StorageError");
+function assertValidationError(assertion, name) {
+    const { message, recoverySuggestion } = validation_1.validationErrorMap[name];
+    if (!assertion) {
+        throw new StorageError_1.StorageError({ name, message, recoverySuggestion });
+    }
+}
+exports.assertValidationError = assertValidationError;

package/lib/index.d.ts

@@ -1,4 +1,6 @@
-import { Storage, StorageInstance } from './Storage';
-export { Storage as StorageClass, StorageInstance as Storage };
-export { AWSS3Provider } from './providers';
-export * from './types';
+export { uploadData, downloadData, remove, list, getProperties, copy, getUrl, } from './providers/s3';
+export { UploadDataInput, DownloadDataInput, RemoveInput, ListAllInput, ListPaginateInput, GetPropertiesInput, CopyInput, GetUrlInput, } from './providers/s3/types/inputs';
+export { UploadDataOutput, DownloadDataOutput, RemoveOutput, ListAllOutput, ListPaginateOutput, GetPropertiesOutput, CopyOutput, GetUrlOutput, } from './providers/s3/types/outputs';
+export { TransferProgressEvent } from './types';
+export { isCancelError } from './errors/CanceledError';
+export { StorageError } from './errors/StorageError';

package/lib/index.js

@@ -1,25 +1,18 @@
 "use strict";
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __exportStar = (this && this.__exportStar) || function(m, exports) {
-    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
-};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AWSS3Provider = exports.Storage = exports.StorageClass = void 0;
-var Storage_1 = require("./Storage");
-Object.defineProperty(exports, "StorageClass", { enumerable: true, get: function () { return Storage_1.Storage; } });
-Object.defineProperty(exports, "Storage", { enumerable: true, get: function () { return Storage_1.StorageInstance; } });
-var providers_1 = require("./providers");
-Object.defineProperty(exports, "AWSS3Provider", { enumerable: true, get: function () { return providers_1.AWSS3Provider; } });
-__exportStar(require("./types"), exports);
+exports.StorageError = exports.isCancelError = exports.getUrl = exports.copy = exports.getProperties = exports.list = exports.remove = exports.downloadData = exports.uploadData = void 0;
+var s3_1 = require("./providers/s3");
+Object.defineProperty(exports, "uploadData", { enumerable: true, get: function () { return s3_1.uploadData; } });
+Object.defineProperty(exports, "downloadData", { enumerable: true, get: function () { return s3_1.downloadData; } });
+Object.defineProperty(exports, "remove", { enumerable: true, get: function () { return s3_1.remove; } });
+Object.defineProperty(exports, "list", { enumerable: true, get: function () { return s3_1.list; } });
+Object.defineProperty(exports, "getProperties", { enumerable: true, get: function () { return s3_1.getProperties; } });
+Object.defineProperty(exports, "copy", { enumerable: true, get: function () { return s3_1.copy; } });
+Object.defineProperty(exports, "getUrl", { enumerable: true, get: function () { return s3_1.getUrl; } });
+// TODO[AllanZhengYP]: support isCancelError in Node.js with node-fetch
+var CanceledError_1 = require("./errors/CanceledError");
+Object.defineProperty(exports, "isCancelError", { enumerable: true, get: function () { return CanceledError_1.isCancelError; } });
+var StorageError_1 = require("./errors/StorageError");
+Object.defineProperty(exports, "StorageError", { enumerable: true, get: function () { return StorageError_1.StorageError; } });

package/lib/providers/s3/apis/copy.d.ts

@@ -0,0 +1,12 @@
+import { CopyInput, CopyOutput } from '../types';
+/**
+ * Copy an object from a source object to a new object within the same bucket. Can optionally copy files across
+ * different level or identityId (if source object's level is 'protected').
+ *
+ * @param input - The CopyInput object.
+ * @returns Output containing the destination key.
+ * @throws service: {@link S3Exception} - Thrown when checking for existence of the object
+ * @throws validation: {@link StorageValidationErrorCode } - Thrown when
+ * source or destination key are not defined.
+ */
+export declare const copy: (input: CopyInput) => Promise<CopyOutput>;

package/lib/providers/s3/apis/copy.js

@@ -0,0 +1,21 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.copy = void 0;
+const core_1 = require("@aws-amplify/core");
+const copy_1 = require("./internal/copy");
+/**
+ * Copy an object from a source object to a new object within the same bucket. Can optionally copy files across
+ * different level or identityId (if source object's level is 'protected').
+ *
+ * @param input - The CopyInput object.
+ * @returns Output containing the destination key.
+ * @throws service: {@link S3Exception} - Thrown when checking for existence of the object
+ * @throws validation: {@link StorageValidationErrorCode } - Thrown when
+ * source or destination key are not defined.
+ */
+const copy = async (input) => {
+    return (0, copy_1.copy)(core_1.Amplify, input);
+};
+exports.copy = copy;

package/lib/providers/s3/apis/downloadData.d.ts

@@ -0,0 +1,32 @@
+import { DownloadDataInput, DownloadDataOutput } from '../types';
+/**
+ * Download S3 object data to memory
+ *
+ * @param input - The DownloadDataInput object.
+ * @returns A cancelable task exposing result promise from `result` property.
+ * @throws service: {@link S3Exception} - thrown when checking for existence of the object
+ * @throws validation: {@link StorageValidationErrorCode } - Validation errors
+ *
+ * @example
+ * ```ts
+ * // Download a file from s3 bucket
+ * const { body, eTag } = await downloadData({ key, data: file, options: {
+ *   onProgress, // Optional progress callback.
+ * } }).result;
+ * ```
+ * @example
+ * ```ts
+ * // Cancel a task
+ * const downloadTask = downloadData({ key, data: file });
+ * //...
+ * downloadTask.cancel();
+ * try {
+ * 	await downloadTask.result;
+ * } catch (error) {
+ * 	if(isCancelError(error)) {
+ *    // Handle error thrown by task cancelation.
+ * 	}
+ * }
+ *```
+ */
+export declare const downloadData: (input: DownloadDataInput) => DownloadDataOutput;

package/lib/providers/s3/apis/downloadData.js

@@ -0,0 +1,81 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.downloadData = void 0;
+const core_1 = require("@aws-amplify/core");
+const utils_1 = require("@aws-amplify/core/internals/utils");
+const resolveS3ConfigAndInput_1 = require("../utils/resolveS3ConfigAndInput");
+const utils_2 = require("../utils");
+const client_1 = require("../utils/client");
+const userAgent_1 = require("../utils/userAgent");
+/**
+ * Download S3 object data to memory
+ *
+ * @param input - The DownloadDataInput object.
+ * @returns A cancelable task exposing result promise from `result` property.
+ * @throws service: {@link S3Exception} - thrown when checking for existence of the object
+ * @throws validation: {@link StorageValidationErrorCode } - Validation errors
+ *
+ * @example
+ * ```ts
+ * // Download a file from s3 bucket
+ * const { body, eTag } = await downloadData({ key, data: file, options: {
+ *   onProgress, // Optional progress callback.
+ * } }).result;
+ * ```
+ * @example
+ * ```ts
+ * // Cancel a task
+ * const downloadTask = downloadData({ key, data: file });
+ * //...
+ * downloadTask.cancel();
+ * try {
+ * 	await downloadTask.result;
+ * } catch (error) {
+ * 	if(isCancelError(error)) {
+ *    // Handle error thrown by task cancelation.
+ * 	}
+ * }
+ *```
+ */
+const downloadData = (input) => {
+    const abortController = new AbortController();
+    const downloadTask = (0, utils_2.createDownloadTask)({
+        job: downloadDataJob(input, abortController.signal),
+        onCancel: (message) => {
+            abortController.abort(message);
+        },
+    });
+    return downloadTask;
+};
+exports.downloadData = downloadData;
+const downloadDataJob = ({ options: downloadDataOptions, key }, abortSignal) => async () => {
+    const { bucket, keyPrefix, s3Config } = await (0, resolveS3ConfigAndInput_1.resolveS3ConfigAndInput)(core_1.Amplify, downloadDataOptions);
+    // TODO[AllanZhengYP]: support excludeSubPaths option to exclude sub paths
+    const finalKey = keyPrefix + key;
+    const { Body: body, LastModified: lastModified, ContentLength: size, ETag: eTag, Metadata: metadata, VersionId: versionId, ContentType: contentType, } = await (0, client_1.getObject)({
+        ...s3Config,
+        abortSignal,
+        onDownloadProgress: downloadDataOptions?.onProgress,
+        userAgentValue: (0, userAgent_1.getStorageUserAgentValue)(utils_1.StorageAction.DownloadData),
+    }, {
+        Bucket: bucket,
+        Key: finalKey,
+        ...(downloadDataOptions?.bytesRange && {
+            Range: `bytes=${downloadDataOptions.bytesRange.start}-${downloadDataOptions.bytesRange.end}`,
+        }),
+    });
+    return {
+        // Casting with ! as body always exists for getObject API.
+        // TODO[AllanZhengYP]: remove casting when we have better typing for getObject API
+        key,
+        body: body,
+        lastModified,
+        size,
+        contentType,
+        eTag,
+        metadata,
+        versionId,
+    };
+};

package/lib/providers/s3/apis/getProperties.d.ts

@@ -0,0 +1,11 @@
+import { GetPropertiesOutput, GetPropertiesInput } from '../types';
+/**
+ * Gets the properties of a file. The properties include S3 system metadata and
+ * the user metadata that was provided when uploading the file.
+ *
+ * @param input - The GetPropertiesInput object.
+ * @returns Requested object properties.
+ * @throws A {@link S3Exception} when the underlying S3 service returned error.
+ * @throws A {@link StorageValidationErrorCode} when API call parameters are invalid.
+ */
+export declare const getProperties: (input: GetPropertiesInput) => Promise<GetPropertiesOutput>;

package/lib/providers/s3/apis/getProperties.js

@@ -0,0 +1,20 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProperties = void 0;
+const core_1 = require("@aws-amplify/core");
+const getProperties_1 = require("./internal/getProperties");
+/**
+ * Gets the properties of a file. The properties include S3 system metadata and
+ * the user metadata that was provided when uploading the file.
+ *
+ * @param input - The GetPropertiesInput object.
+ * @returns Requested object properties.
+ * @throws A {@link S3Exception} when the underlying S3 service returned error.
+ * @throws A {@link StorageValidationErrorCode} when API call parameters are invalid.
+ */
+const getProperties = (input) => {
+    return (0, getProperties_1.getProperties)(core_1.Amplify, input);
+};
+exports.getProperties = getProperties;

package/lib/providers/s3/apis/getUrl.d.ts

@@ -0,0 +1,18 @@
+import { GetUrlInput, GetUrlOutput } from '../types';
+/**
+ * Get a temporary presigned URL to download the specified S3 object.
+ * The presigned URL expires when the associated role used to sign the request expires or
+ * the option  `expiresIn` is reached. The `expiresAt` property in the output object indicates when the URL MAY expire.
+ *
+ * By default, it will not validate the object that exists in S3. If you set the `options.validateObjectExistence`
+ * to true, this method will verify the given object already exists in S3 before returning a presigned
+ * URL, and will throw {@link StorageError} if the object does not exist.
+ *
+ * @param input - The GetUrlInput object.
+ * @returns Presigned URL and timestamp when the URL MAY expire.
+ * @throws service: {@link S3Exception} - thrown when checking for existence of the object
+ * @throws validation: {@link StorageValidationErrorCode } - Validation errors
+ * thrown either username or key are not defined.
+ *
+ */
+export declare const getUrl: (input: GetUrlInput) => Promise<GetUrlOutput>;

package/lib/providers/s3/apis/getUrl.js

@@ -0,0 +1,27 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUrl = void 0;
+const core_1 = require("@aws-amplify/core");
+const getUrl_1 = require("./internal/getUrl");
+/**
+ * Get a temporary presigned URL to download the specified S3 object.
+ * The presigned URL expires when the associated role used to sign the request expires or
+ * the option  `expiresIn` is reached. The `expiresAt` property in the output object indicates when the URL MAY expire.
+ *
+ * By default, it will not validate the object that exists in S3. If you set the `options.validateObjectExistence`
+ * to true, this method will verify the given object already exists in S3 before returning a presigned
+ * URL, and will throw {@link StorageError} if the object does not exist.
+ *
+ * @param input - The GetUrlInput object.
+ * @returns Presigned URL and timestamp when the URL MAY expire.
+ * @throws service: {@link S3Exception} - thrown when checking for existence of the object
+ * @throws validation: {@link StorageValidationErrorCode } - Validation errors
+ * thrown either username or key are not defined.
+ *
+ */
+const getUrl = (input) => {
+    return (0, getUrl_1.getUrl)(core_1.Amplify, input);
+};
+exports.getUrl = getUrl;

package/lib/providers/s3/apis/index.d.ts

@@ -0,0 +1,7 @@
+export { uploadData } from './uploadData';
+export { downloadData } from './downloadData';
+export { remove } from './remove';
+export { list } from './list';
+export { getProperties } from './getProperties';
+export { copy } from './copy';
+export { getUrl } from './getUrl';

package/lib/providers/s3/apis/index.js

@@ -0,0 +1,19 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUrl = exports.copy = exports.getProperties = exports.list = exports.remove = exports.downloadData = exports.uploadData = void 0;
+var uploadData_1 = require("./uploadData");
+Object.defineProperty(exports, "uploadData", { enumerable: true, get: function () { return uploadData_1.uploadData; } });
+var downloadData_1 = require("./downloadData");
+Object.defineProperty(exports, "downloadData", { enumerable: true, get: function () { return downloadData_1.downloadData; } });
+var remove_1 = require("./remove");
+Object.defineProperty(exports, "remove", { enumerable: true, get: function () { return remove_1.remove; } });
+var list_1 = require("./list");
+Object.defineProperty(exports, "list", { enumerable: true, get: function () { return list_1.list; } });
+var getProperties_1 = require("./getProperties");
+Object.defineProperty(exports, "getProperties", { enumerable: true, get: function () { return getProperties_1.getProperties; } });
+var copy_1 = require("./copy");
+Object.defineProperty(exports, "copy", { enumerable: true, get: function () { return copy_1.copy; } });
+var getUrl_1 = require("./getUrl");
+Object.defineProperty(exports, "getUrl", { enumerable: true, get: function () { return getUrl_1.getUrl; } });

package/lib/providers/s3/apis/internal/copy.d.ts

@@ -0,0 +1,3 @@
+import { AmplifyClassV6 } from '@aws-amplify/core';
+import { CopyInput, CopyOutput } from '../../types';
+export declare const copy: (amplify: AmplifyClassV6, input: CopyInput) => Promise<CopyOutput>;

package/lib/providers/s3/apis/internal/copy.js

@@ -0,0 +1,33 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.copy = void 0;
+const utils_1 = require("@aws-amplify/core/internals/utils");
+const utils_2 = require("../../utils");
+const validation_1 = require("../../../../errors/types/validation");
+const assertValidationError_1 = require("../../../../errors/utils/assertValidationError");
+const client_1 = require("../../utils/client");
+const userAgent_1 = require("../../utils/userAgent");
+const copy = async (amplify, input) => {
+    const { source: { key: sourceKey }, destination: { key: destinationKey }, } = input;
+    (0, assertValidationError_1.assertValidationError)(!!sourceKey, validation_1.StorageValidationErrorCode.NoSourceKey);
+    (0, assertValidationError_1.assertValidationError)(!!destinationKey, validation_1.StorageValidationErrorCode.NoDestinationKey);
+    const { s3Config, bucket, keyPrefix: sourceKeyPrefix, } = await (0, utils_2.resolveS3ConfigAndInput)(amplify, input.source);
+    const { keyPrefix: destinationKeyPrefix } = await (0, utils_2.resolveS3ConfigAndInput)(amplify, input.destination); // resolveS3ConfigAndInput does not make extra API calls or storage access if called repeatedly.
+    // TODO(ashwinkumar6) V6-logger: warn `You may copy files from another user if the source level is "protected", currently it's ${srcLevel}`
+    // TODO(ashwinkumar6) V6-logger: debug `copying ${finalSrcKey} to ${finalDestKey}`
+    await (0, client_1.copyObject)({
+        ...s3Config,
+        userAgentValue: (0, userAgent_1.getStorageUserAgentValue)(utils_1.StorageAction.Copy)
+    }, {
+        Bucket: bucket,
+        CopySource: `${bucket}/${sourceKeyPrefix}${sourceKey}`,
+        Key: `${destinationKeyPrefix}${destinationKey}`,
+        MetadataDirective: 'COPY', // Copies over metadata like contentType as well
+    });
+    return {
+        key: destinationKey,
+    };
+};
+exports.copy = copy;

package/lib/providers/s3/apis/internal/getProperties.d.ts

@@ -0,0 +1,4 @@
+import { AmplifyClassV6 } from '@aws-amplify/core';
+import { StorageAction } from '@aws-amplify/core/internals/utils';
+import { GetPropertiesInput, GetPropertiesOutput } from '../../types';
+export declare const getProperties: (amplify: AmplifyClassV6, input: GetPropertiesInput, action?: StorageAction) => Promise<GetPropertiesOutput>;

package/lib/providers/s3/apis/internal/getProperties.js

@@ -0,0 +1,30 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getProperties = void 0;
+const utils_1 = require("@aws-amplify/core/internals/utils");
+const utils_2 = require("../../utils");
+const client_1 = require("../../utils/client");
+const userAgent_1 = require("../../utils/userAgent");
+const getProperties = async function (amplify, input, action) {
+    const { key, options } = input;
+    const { s3Config, bucket, keyPrefix } = await (0, utils_2.resolveS3ConfigAndInput)(amplify, options);
+    const response = await (0, client_1.headObject)({
+        ...s3Config,
+        userAgentValue: (0, userAgent_1.getStorageUserAgentValue)(action ?? utils_1.StorageAction.GetProperties)
+    }, {
+        Bucket: bucket,
+        Key: `${keyPrefix}${key}`,
+    });
+    return {
+        key,
+        contentType: response.ContentType,
+        size: response.ContentLength,
+        eTag: response.ETag,
+        lastModified: response.LastModified,
+        metadata: response.Metadata,
+        versionId: response.VersionId,
+    };
+};
+exports.getProperties = getProperties;

package/lib/providers/s3/apis/internal/getUrl.d.ts

@@ -0,0 +1,3 @@
+import { AmplifyClassV6 } from '@aws-amplify/core';
+import { GetUrlInput, GetUrlOutput } from '../../types';
+export declare const getUrl: (amplify: AmplifyClassV6, input: GetUrlInput) => Promise<GetUrlOutput>;

package/lib/providers/s3/apis/internal/getUrl.js

@@ -0,0 +1,39 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getUrl = void 0;
+const validation_1 = require("../../../../errors/types/validation");
+const client_1 = require("../../utils/client");
+const getProperties_1 = require("./getProperties");
+const utils_1 = require("../../utils");
+const assertValidationError_1 = require("../../../../errors/utils/assertValidationError");
+const constants_1 = require("../../utils/constants");
+const utils_2 = require("@aws-amplify/core/internals/utils");
+const getUrl = async function (amplify, input) {
+    const { key, options } = input;
+    if (options?.validateObjectExistence) {
+        await (0, getProperties_1.getProperties)(amplify, { key, options }, utils_2.StorageAction.GetUrl);
+    }
+    const { s3Config, keyPrefix, bucket } = await (0, utils_1.resolveS3ConfigAndInput)(amplify, options);
+    let urlExpirationInSec = options?.expiresIn ?? constants_1.DEFAULT_PRESIGN_EXPIRATION;
+    const awsCredExpiration = s3Config.credentials?.expiration;
+    if (awsCredExpiration) {
+        const awsCredExpirationInSec = Math.floor((awsCredExpiration.getTime() - Date.now()) / 1000);
+        urlExpirationInSec = Math.min(awsCredExpirationInSec, urlExpirationInSec);
+    }
+    const maxUrlExpirationInSec = constants_1.MAX_URL_EXPIRATION / 1000;
+    (0, assertValidationError_1.assertValidationError)(urlExpirationInSec <= maxUrlExpirationInSec, validation_1.StorageValidationErrorCode.UrlExpirationMaxLimitExceed);
+    // expiresAt is the minimum of credential expiration and url expiration
+    return {
+        url: await (0, client_1.getPresignedGetObjectUrl)({
+            ...s3Config,
+            expiration: urlExpirationInSec,
+        }, {
+            Bucket: bucket,
+            Key: `${keyPrefix}${key}`,
+        }),
+        expiresAt: new Date(Date.now() + urlExpirationInSec * 1000),
+    };
+};
+exports.getUrl = getUrl;

package/lib/providers/s3/apis/internal/list.d.ts

@@ -0,0 +1,3 @@
+import { AmplifyClassV6 } from '@aws-amplify/core';
+import { ListAllInput, ListPaginateInput, ListAllOutput, ListPaginateOutput } from '../../types';
+export declare const list: (amplify: AmplifyClassV6, input?: ListAllInput | ListPaginateInput) => Promise<ListAllOutput | ListPaginateOutput>;