@aws-amplify/storage 6.6.10 → 6.6.11-storage-browser-integrity.2a9053f.0

package/src/providers/s3/utils/client/utils/deserializeHelpers.ts

@@ -5,6 +5,7 @@ import { Headers } from '@aws-amplify/core/internals/aws-client-utils';
 import { ServiceError } from '@aws-amplify/core/internals/utils';
 
 import { StorageError } from '../../../../../errors/StorageError';
+import { CompletedPart } from '../s3data';
 
 type PropertyNameWithStringValue = string;
 type PropertyNameWithSubsequentDeserializer<T> = [string, (arg: any) => T];
@@ -104,6 +105,47 @@ export const deserializeTimestamp = (value: string): Date | undefined => {
 	return value ? new Date(value) : undefined;
 };
 
+/**
+ * Create a function deserializing a string to an enum value. If the string is not a valid enum value, it throws a
+ * StorageError.
+ *
+ * @example
+ * ```typescript
+ * const deserializeStringEnum = createStringEnumDeserializer(['a', 'b', 'c'] as const, 'FieldName');
+ * const deserializedArray = ['a', 'b', 'c'].map(deserializeStringEnum);
+ * // deserializedArray = ['a', 'b', 'c']
+ *
+ * const invalidValue = deserializeStringEnum('d');
+ * // Throws InvalidFieldName: Invalid FieldName: d
+ * ```
+ *
+ * @internal
+ */
+export const createStringEnumDeserializer = <T extends readonly string[]>(
+	enumValues: T,
+	fieldName: string,
+) => {
+	const deserializeStringEnum = (
+		value: any,
+	): T extends (infer E)[] ? E : never => {
+		const parsedEnumValue = value
+			? (enumValues.find(enumValue => enumValue === value) as any)
+			: undefined;
+		if (!parsedEnumValue) {
+			throw new StorageError({
+				name: `Invalid${fieldName}`,
+				message: `Invalid ${fieldName}: ${value}`,
+				recoverySuggestion:
+					'This is likely to be a bug. Please reach out to library authors.',
+			});
+		}
+
+		return parsedEnumValue;
+	};
+
+	return deserializeStringEnum;
+};
+
 /**
  * Function that makes sure the deserializer receives non-empty array.
  *
@@ -161,3 +203,18 @@ export const buildStorageServiceError = (
 
 	return storageError;
 };
+
+/**
+ * Internal-only method used for deserializing the parts of a multipart upload.
+ *
+ * @internal
+ */
+export const deserializeCompletedPartList = (input: any[]): CompletedPart[] =>
+	input.map(item =>
+		map(item, {
+			PartNumber: ['PartNumber', deserializeNumber],
+			ETag: 'ETag',
+			Size: ['Size', deserializeNumber],
+			ChecksumCRC32: 'ChecksumCRC32',
+		}),
+	);

package/src/providers/s3/utils/client/utils/index.ts

@@ -1,7 +1,7 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
 
-export { parseXmlBody, parseXmlError } from './parsePayload';
+export { parseXmlBody, createXmlErrorParser } from './parsePayload';
 export {
 	SEND_DOWNLOAD_PROGRESS_EVENT,
 	SEND_UPLOAD_PROGRESS_EVENT,
@@ -13,6 +13,7 @@ export {
 export {
 	buildStorageServiceError,
 	deserializeBoolean,
+	deserializeCompletedPartList,
 	deserializeMetadata,
 	deserializeNumber,
 	deserializeTimestamp,
@@ -25,3 +26,5 @@ export {
 	serializePathnameObjectKey,
 	validateS3RequiredParameter,
 } from './serializeHelpers';
+export { createRetryDecider } from './createRetryDecider';
+export { bothNilOrEqual } from './integrityHelpers';

package/src/providers/s3/utils/client/utils/integrityHelpers.ts

@@ -0,0 +1,62 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+export const isNil = <T>(value?: T) => {
+	return value === undefined || value === null;
+};
+
+export const bothNilOrEqual = (original?: string, output?: string): boolean => {
+	return (isNil(original) && isNil(output)) || original === output;
+};
+
+/**
+ * This function is used to determine if a value is an object.
+ * It excludes arrays and null values.
+ *
+ * @param value
+ * @returns
+ */
+export const isObject = <T>(value?: T) => {
+	return value != null && typeof value === 'object' && !Array.isArray(value);
+};
+
+/**
+ * This function is used to compare two objects and determine if they are equal.
+ * It handles nested objects and arrays as well.
+ * Array order is not taken into account.
+ *
+ * @param object
+ * @param other
+ * @returns
+ */
+export const isEqual = <T>(object: T, other: T): boolean => {
+	if (Array.isArray(object) && !Array.isArray(other)) {
+		return false;
+	}
+	if (!Array.isArray(object) && Array.isArray(other)) {
+		return false;
+	}
+	if (Array.isArray(object) && Array.isArray(other)) {
+		return (
+			object.length === other.length &&
+			object.every((val, ix) => isEqual(val, other[ix]))
+		);
+	}
+	if (!isObject<T>(object) || !isObject<T>(other)) {
+		return object === other;
+	}
+
+	const objectKeys = Object.keys(object as any);
+	const otherKeys = Object.keys(other as any);
+
+	if (objectKeys.length !== otherKeys.length) {
+		return false;
+	}
+
+	return objectKeys.every(key => {
+		return (
+			otherKeys.includes(key) &&
+			isEqual(object[key as keyof T] as any, other[key as keyof T] as any)
+		);
+	});
+};

package/src/providers/s3/utils/client/utils/parsePayload.ts

@@ -9,25 +9,43 @@ import {
 
 import { parser } from '../runtime';
 
-export const parseXmlError: ErrorParser = async (response?: HttpResponse) => {
-	if (!response || response.statusCode < 300) {
-		return;
-	}
-	const { statusCode } = response;
-	const body = await parseXmlBody(response);
-	const code = body?.Code
-		? (body.Code as string)
-		: statusCode === 404
-			? 'NotFound'
-			: statusCode.toString();
-	const message = body?.message ?? body?.Message ?? code;
-	const error = new Error(message);
+/**
+ * Factory creating a parser that parses the JS Error object from the XML
+ * response payload.
+ *
+ * @param input Input object
+ * @param input.noErrorWrapping Whether the error code and message are located
+ *   directly in the root XML element, or in a nested `<Error>` element.
+ *   See: https://smithy.io/2.0/aws/protocols/aws-restxml-protocol.html#restxml-errors
+ *
+ *   Default to false.
+ *
+ * @internal
+ */
+export const createXmlErrorParser =
+	({
+		noErrorWrapping = false,
+	}: { noErrorWrapping?: boolean } = {}): ErrorParser =>
+	async (response?: HttpResponse) => {
+		if (!response || response.statusCode < 300) {
+			return;
+		}
+		const { statusCode } = response;
+		const body = await parseXmlBody(response);
+		const errorLocation = noErrorWrapping ? body : body.Error;
+		const code = errorLocation?.Code
+			? (errorLocation.Code as string)
+			: statusCode === 404
+				? 'NotFound'
+				: statusCode.toString();
+		const message = errorLocation?.message ?? errorLocation?.Message ?? code;
+		const error = new Error(message);
 
-	return Object.assign(error, {
-		name: code,
-		$metadata: parseMetadata(response),
-	});
-};
+		return Object.assign(error, {
+			name: code,
+			$metadata: parseMetadata(response),
+		});
+	};
 
 export const parseXmlBody = async (response: HttpResponse): Promise<any> => {
 	if (!response.body) {

package/src/providers/s3/utils/constants.ts

@@ -13,6 +13,9 @@ const MiB = 1024 * 1024;
 const GiB = 1024 * MiB;
 const TiB = 1024 * GiB;
 
+/**
+ * Default part size in MB that is used to determine if an upload task is single part or multi part.
+ */
 export const DEFAULT_PART_SIZE = 5 * MiB;
 export const MAX_OBJECT_SIZE = 5 * TiB;
 export const MAX_PARTS_COUNT = 10000;

package/src/providers/s3/utils/crc32.native.ts

@@ -0,0 +1,11 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+import { CRC32Checksum } from './crc32';
+
+export const calculateContentCRC32 = async (
+	content: Blob | string | ArrayBuffer | ArrayBufferView,
+	_seed = 0,
+): Promise<CRC32Checksum | undefined> => {
+	return undefined;
+};

package/src/providers/s3/utils/crc32.ts

@@ -0,0 +1,51 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+import crc32 from 'crc-32';
+
+export interface CRC32Checksum {
+	checksumArrayBuffer: ArrayBuffer;
+	checksum: string;
+	seed: number;
+}
+
+export const calculateContentCRC32 = async (
+	content: Blob | string | ArrayBuffer | ArrayBufferView,
+	seed = 0,
+): Promise<CRC32Checksum | undefined> => {
+	let internalSeed = seed;
+	let blob: Blob;
+
+	if (content instanceof Blob) {
+		blob = content;
+	} else {
+		blob = new Blob([content]);
+	}
+
+	await blob.stream().pipeTo(
+		new WritableStream<Uint8Array>({
+			write(chunk) {
+				internalSeed = crc32.buf(chunk, internalSeed) >>> 0;
+			},
+		}),
+	);
+	const hex = internalSeed.toString(16).padStart(8, '0');
+
+	return {
+		checksumArrayBuffer: hexToArrayBuffer(hex),
+		checksum: hexToBase64(hex),
+		seed: internalSeed,
+	};
+};
+
+const hexToArrayBuffer = (hexString: string) =>
+	new Uint8Array((hexString.match(/\w{2}/g)! ?? []).map(h => parseInt(h, 16)))
+		.buffer;
+
+const hexToBase64 = (hexString: string) =>
+	btoa(
+		hexString
+			.match(/\w{2}/g)!
+			.map((a: string) => String.fromCharCode(parseInt(a, 16)))
+			.join(''),
+	);

package/src/providers/s3/utils/index.ts

@@ -4,6 +4,7 @@
 export { calculateContentMd5 } from './md5';
 export { resolveS3ConfigAndInput } from './resolveS3ConfigAndInput';
 export { createDownloadTask, createUploadTask } from './transferTask';
+export { validateBucketOwnerID } from './validateBucketOwnerID';
 export { validateStorageOperationInput } from './validateStorageOperationInput';
 export { validateStorageOperationInputWithPrefix } from './validateStorageOperationInputWithPrefix';
 export { isInputWithPath } from './isInputWithPath';

package/src/providers/s3/utils/resolveIdentityId.ts

@@ -0,0 +1,11 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+import { StorageValidationErrorCode } from '../../../errors/types/validation';
+import { assertValidationError } from '../../../errors/utils/assertValidationError';
+
+export const resolveIdentityId = (identityId?: string): string => {
+	assertValidationError(!!identityId, StorageValidationErrorCode.NoIdentityId);
+
+	return identityId;
+};

package/src/providers/s3/utils/resolveS3ConfigAndInput.ts

@@ -2,11 +2,25 @@
 // SPDX-License-Identifier: Apache-2.0
 
 import { AmplifyClassV6, StorageAccessLevel } from '@aws-amplify/core';
+import { CredentialsProviderOptions } from '@aws-amplify/core/internals/aws-client-utils';
 
 import { assertValidationError } from '../../../errors/utils/assertValidationError';
 import { StorageValidationErrorCode } from '../../../errors/types/validation';
 import { resolvePrefix as defaultPrefixResolver } from '../../../utils/resolvePrefix';
-import { BucketInfo, ResolvedS3Config, StorageBucket } from '../types/options';
+import {
+	StorageOperationInputWithKey,
+	StorageOperationInputWithPath,
+	StorageOperationInputWithPrefix,
+} from '../../../types/inputs';
+import { StorageError } from '../../../errors/StorageError';
+import { CopyInput, CopyWithPathInput } from '../types';
+import { INVALID_STORAGE_INPUT } from '../../../errors/constants';
+import {
+	BucketInfo,
+	LocationCredentialsProvider,
+	ResolvedS3Config,
+	StorageBucket,
+} from '../types/options';
 
 import { DEFAULT_ACCESS_LEVEL, LOCAL_TESTING_S3_ENDPOINT } from './constants';
 
@@ -14,6 +28,7 @@ interface S3ApiOptions {
 	accessLevel?: StorageAccessLevel;
 	targetIdentityId?: string;
 	useAccelerateEndpoint?: boolean;
+	locationCredentialsProvider?: LocationCredentialsProvider;
 	bucket?: StorageBucket;
 }
 
@@ -24,6 +39,16 @@ interface ResolvedS3ConfigAndInput {
 	isObjectLockEnabled?: boolean;
 	identityId?: string;
 }
+export type DeprecatedStorageInput =
+	| StorageOperationInputWithKey
+	| StorageOperationInputWithPrefix
+	| CopyInput;
+
+export type CallbackPathStorageInput =
+	| StorageOperationInputWithPath
+	| CopyWithPathInput;
+
+type StorageInput = DeprecatedStorageInput | CallbackPathStorageInput;
 
 /**
  * resolve the common input options for S3 API handlers from Amplify configuration and library options.
@@ -38,23 +63,35 @@ interface ResolvedS3ConfigAndInput {
  */
 export const resolveS3ConfigAndInput = async (
 	amplify: AmplifyClassV6,
-	apiOptions?: S3ApiOptions,
+	apiInput?: StorageInput & { options?: S3ApiOptions },
 ): Promise<ResolvedS3ConfigAndInput> => {
+	const { options: apiOptions } = apiInput ?? {};
 	/**
 	 * IdentityId is always cached in memory so we can safely make calls here. It
 	 * should be stable even for unauthenticated users, regardless of credentials.
 	 */
 	const { identityId } = await amplify.Auth.fetchAuthSession();
-	assertValidationError(!!identityId, StorageValidationErrorCode.NoIdentityId);
 
 	/**
 	 * A credentials provider function instead of a static credentials object is
 	 * used because the long-running tasks like multipart upload may span over the
 	 * credentials expiry. Auth.fetchAuthSession() automatically refreshes the
 	 * credentials if they are expired.
+	 *
+	 * The optional forceRefresh option is set when the S3 service returns expired
+	 * tokens error in the previous API call attempt.
 	 */
-	const credentialsProvider = async () => {
-		const { credentials } = await amplify.Auth.fetchAuthSession();
+	const credentialsProvider = async (options?: CredentialsProviderOptions) => {
+		if (isLocationCredentialsProvider(apiOptions)) {
+			assertStorageInput(apiInput);
+		}
+
+		// TODO: forceRefresh option of fetchAuthSession would refresh both tokens and
+		// AWS credentials. So we do not support forceRefreshing from the Auth until
+		// we support refreshing only the credentials.
+		const { credentials } = isLocationCredentialsProvider(apiOptions)
+			? await apiOptions.locationCredentialsProvider(options)
+			: await amplify.Auth.fetchAuthSession();
 		assertValidationError(
 			!!credentials,
 			StorageValidationErrorCode.NoCredentials,
@@ -82,15 +119,14 @@ export const resolveS3ConfigAndInput = async (
 		isObjectLockEnabled,
 	} = amplify.libraryOptions?.Storage?.S3 ?? {};
 
-	const keyPrefix = await prefixResolver({
-		accessLevel:
-			apiOptions?.accessLevel ?? defaultAccessLevel ?? DEFAULT_ACCESS_LEVEL,
-		// use conditional assign to make tsc happy because StorageOptions is a union type that may not have targetIdentityId
-		targetIdentityId:
-			apiOptions?.accessLevel === 'protected'
-				? (apiOptions?.targetIdentityId ?? identityId)
-				: identityId,
-	});
+	const accessLevel =
+		apiOptions?.accessLevel ?? defaultAccessLevel ?? DEFAULT_ACCESS_LEVEL;
+	const targetIdentityId =
+		accessLevel === 'protected'
+			? (apiOptions?.targetIdentityId ?? identityId)
+			: identityId;
+
+	const keyPrefix = await prefixResolver({ accessLevel, targetIdentityId });
 
 	return {
 		s3Config: {
@@ -111,6 +147,65 @@ export const resolveS3ConfigAndInput = async (
 	};
 };
 
+const isLocationCredentialsProvider = (
+	options?: S3ApiOptions,
+): options is S3ApiOptions & {
+	locationCredentialsProvider: LocationCredentialsProvider;
+} => {
+	return !!options?.locationCredentialsProvider;
+};
+
+const isInputWithCallbackPath = (input?: CallbackPathStorageInput) => {
+	return (
+		((input as StorageOperationInputWithPath)?.path &&
+			typeof (input as StorageOperationInputWithPath).path === 'function') ||
+		((input as CopyWithPathInput)?.destination?.path &&
+			typeof (input as CopyWithPathInput).destination?.path === 'function') ||
+		((input as CopyWithPathInput)?.source?.path &&
+			typeof (input as CopyWithPathInput).source?.path === 'function')
+	);
+};
+
+const isDeprecatedInput = (
+	input?: StorageInput,
+): input is DeprecatedStorageInput => {
+	return (
+		isInputWithKey(input) ||
+		isInputWithPrefix(input) ||
+		isInputWithCopySourceOrDestination(input)
+	);
+};
+const assertStorageInput = (input?: StorageInput) => {
+	if (isDeprecatedInput(input) || isInputWithCallbackPath(input)) {
+		throw new StorageError({
+			name: INVALID_STORAGE_INPUT,
+			message: 'The input needs to have a path as a string value.',
+			recoverySuggestion:
+				'Please provide a valid path as a string value for the input.',
+		});
+	}
+};
+
+const isInputWithKey = (
+	input?: StorageInput,
+): input is StorageOperationInputWithKey => {
+	return !!(typeof (input as StorageOperationInputWithKey).key === 'string');
+};
+const isInputWithPrefix = (
+	input?: StorageInput,
+): input is StorageOperationInputWithPrefix => {
+	return !!(
+		typeof (input as StorageOperationInputWithPrefix).prefix === 'string'
+	);
+};
+const isInputWithCopySourceOrDestination = (
+	input?: StorageInput,
+): input is CopyInput => {
+	return !!(
+		typeof (input as CopyInput).source?.key === 'string' ||
+		typeof (input as CopyInput).destination?.key === 'string'
+	);
+};
 const resolveBucketConfig = (
 	apiOptions: S3ApiOptions,
 	buckets: Record<string, BucketInfo> | undefined,

package/src/providers/s3/utils/validateBucketOwnerID.ts

@@ -0,0 +1,18 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+import { StorageValidationErrorCode } from '../../../errors/types/validation';
+import { assertValidationError } from '../../../errors/utils/assertValidationError';
+
+const VALID_AWS_ACCOUNT_ID_PATTERN = /^\d{12}/;
+
+export const validateBucketOwnerID = (accountID?: string) => {
+	if (accountID === undefined) {
+		return;
+	}
+
+	assertValidationError(
+		VALID_AWS_ACCOUNT_ID_PATTERN.test(accountID),
+		StorageValidationErrorCode.InvalidAWSAccountID,
+	);
+};

package/src/providers/s3/utils/validateMultipartUploadXML.ts

@@ -0,0 +1,36 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+import { IntegrityError } from '../../../errors/IntegrityError';
+
+import { parser } from './client/runtime';
+import { CompletedMultipartUpload } from './client/s3data/types';
+import {
+	deserializeCompletedPartList,
+	emptyArrayGuard,
+	map,
+} from './client/utils';
+import { isEqual } from './client/utils/integrityHelpers';
+
+export function validateMultipartUploadXML(
+	input: CompletedMultipartUpload,
+	xml: string,
+) {
+	if (!input.Parts) {
+		throw new IntegrityError();
+	}
+	const parsedXML = parser.parse(xml);
+	const mappedCompletedMultipartUpload: CompletedMultipartUpload = map(
+		parsedXML,
+		{
+			Parts: [
+				'Part',
+				value => emptyArrayGuard(value, deserializeCompletedPartList),
+			],
+		},
+	);
+
+	if (!isEqual(input, mappedCompletedMultipartUpload)) {
+		throw new IntegrityError();
+	}
+}

package/src/providers/s3/utils/validateObjectUrl.ts

@@ -0,0 +1,32 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+import { extendedEncodeURIComponent } from '@aws-amplify/core/internals/aws-client-utils';
+
+import { IntegrityError } from '../../../errors/IntegrityError';
+
+export function validateObjectUrl({
+	bucketName,
+	key,
+	objectURL,
+}: {
+	bucketName?: string;
+	key?: string;
+	objectURL?: URL;
+}): void {
+	if (!bucketName || !key || !objectURL) {
+		throw new IntegrityError();
+	}
+	const bucketWithDots = bucketName.includes('.');
+	const encodedBucketName = extendedEncodeURIComponent(bucketName);
+	const encodedKey = key.split('/').map(extendedEncodeURIComponent).join('/');
+	const isPathStyleUrl =
+		objectURL.pathname === `/${encodedBucketName}/${encodedKey}`;
+	const isSubdomainUrl =
+		objectURL.hostname.startsWith(`${encodedBucketName}.`) &&
+		objectURL.pathname === `/${encodedKey}`;
+
+	if (!(isPathStyleUrl || (!bucketWithDots && isSubdomainUrl))) {
+		throw new IntegrityError();
+	}
+}

package/src/providers/s3/utils/validateStorageOperationInput.ts

@@ -7,6 +7,7 @@ import { StorageValidationErrorCode } from '../../../errors/types/validation';
 
 import { isInputWithPath } from './isInputWithPath';
 import { STORAGE_INPUT_KEY, STORAGE_INPUT_PATH } from './constants';
+import { resolveIdentityId } from './resolveIdentityId';
 
 export const validateStorageOperationInput = (
 	input: Input,
@@ -22,7 +23,10 @@ export const validateStorageOperationInput = (
 
 	if (isInputWithPath(input)) {
 		const { path } = input;
-		const objectKey = typeof path === 'string' ? path : path({ identityId });
+		const objectKey =
+			typeof path === 'string'
+				? path
+				: path({ identityId: resolveIdentityId(identityId) });
 
 		assertValidationError(
 			!objectKey.startsWith('/'),

package/src/providers/s3/utils/validateStorageOperationInputWithPrefix.ts

@@ -9,6 +9,7 @@ import { assertValidationError } from '../../../errors/utils/assertValidationErr
 import { StorageValidationErrorCode } from '../../../errors/types/validation';
 
 import { STORAGE_INPUT_PATH, STORAGE_INPUT_PREFIX } from './constants';
+import { resolveIdentityId } from './resolveIdentityId';
 
 // Local assertion function with StorageOperationInputWithPrefixPath as Input
 const _isInputWithPath = (
@@ -28,7 +29,10 @@ export const validateStorageOperationInputWithPrefix = (
 	);
 	if (_isInputWithPath(input)) {
 		const { path } = input;
-		const objectKey = typeof path === 'string' ? path : path({ identityId });
+		const objectKey =
+			typeof path === 'string'
+				? path
+				: path({ identityId: resolveIdentityId(identityId) });
 
 		// Assert on no leading slash in the path parameter
 		assertValidationError(

package/src/types/inputs.ts

@@ -3,7 +3,10 @@
 
 import { StrictUnion } from '@aws-amplify/core/internals/utils';
 
-import { StorageBucket } from '../providers/s3/types/options';
+import {
+	CopyWithPathDestinationOptions,
+	CopyWithPathSourceOptions,
+} from '../providers/s3/types/options';
 
 import {
 	StorageListAllOptions,
@@ -93,8 +96,8 @@ export interface StorageCopyInputWithKey<
 }
 
 export interface StorageCopyInputWithPath {
-	source: StorageOperationInputWithPath & { bucket?: StorageBucket };
-	destination: StorageOperationInputWithPath & { bucket?: StorageBucket };
+	source: StorageOperationInputWithPath & CopyWithPathSourceOptions;
+	destination: StorageOperationInputWithPath & CopyWithPathDestinationOptions;
 }
 
 /**

package/dist/cjs/providers/s3/apis/uploadData/byteLength.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"byteLength.js","sources":["../../../../../../src/providers/s3/apis/uploadData/byteLength.ts"],"sourcesContent":["\"use strict\";\n// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.byteLength = void 0;\n/**\n * Calculate the total size of the data to be uploaded. The total size is not required for multipart upload, as it's\n * only used in progress report.\n */\nconst byteLength = (input) => {\n    if (input === null || input === undefined)\n        return 0;\n    if (typeof input === 'string') {\n        let len = input.length;\n        for (let i = len - 1; i >= 0; i--) {\n            const code = input.charCodeAt(i);\n            if (code > 0x7f && code <= 0x7ff)\n                len++;\n            else if (code > 0x7ff && code <= 0xffff)\n                len += 2;\n            if (code >= 0xdc00 && code <= 0xdfff)\n                i--; // trail surrogate\n        }\n        return len;\n    }\n    else if (typeof input.byteLength === 'number') {\n        // handles Uint8Array, ArrayBuffer, Buffer, and ArrayBufferView\n        return input.byteLength;\n    }\n    else if (typeof input.size === 'number') {\n        // handles browser File object\n        return input.size;\n    }\n    // TODO: support Node.js stream size when Node.js runtime is supported out-of-box.\n    return undefined;\n};\nexports.byteLength = byteLength;\n"],"names":[],"mappings":";;AACA;AACA;AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9D,OAAO,CAAC,UAAU,GAAG,KAAK,CAAC,CAAC;AAC5B;AACA;AACA;AACA;AACA,MAAM,UAAU,GAAG,CAAC,KAAK,KAAK;AAC9B,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;AAC7C,QAAQ,OAAO,CAAC,CAAC;AACjB,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE;AACnC,QAAQ,IAAI,GAAG,GAAG,KAAK,CAAC,MAAM,CAAC;AAC/B,QAAQ,KAAK,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE;AAC3C,YAAY,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;AAC7C,YAAY,IAAI,IAAI,GAAG,IAAI,IAAI,IAAI,IAAI,KAAK;AAC5C,gBAAgB,GAAG,EAAE,CAAC;AACtB,iBAAiB,IAAI,IAAI,GAAG,KAAK,IAAI,IAAI,IAAI,MAAM;AACnD,gBAAgB,GAAG,IAAI,CAAC,CAAC;AACzB,YAAY,IAAI,IAAI,IAAI,MAAM,IAAI,IAAI,IAAI,MAAM;AAChD,gBAAgB,CAAC,EAAE,CAAC;AACpB,SAAS;AACT,QAAQ,OAAO,GAAG,CAAC;AACnB,KAAK;AACL,SAAS,IAAI,OAAO,KAAK,CAAC,UAAU,KAAK,QAAQ,EAAE;AACnD;AACA,QAAQ,OAAO,KAAK,CAAC,UAAU,CAAC;AAChC,KAAK;AACL,SAAS,IAAI,OAAO,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE;AAC7C;AACA,QAAQ,OAAO,KAAK,CAAC,IAAI,CAAC;AAC1B,KAAK;AACL;AACA,IAAI,OAAO,SAAS,CAAC;AACrB,CAAC,CAAC;AACF,OAAO,CAAC,UAAU,GAAG,UAAU;;"}

package/dist/cjs/providers/s3/apis/uploadData/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sources":["../../../../../../src/providers/s3/apis/uploadData/index.ts"],"sourcesContent":["\"use strict\";\n// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.uploadData = void 0;\nconst utils_1 = require(\"../../utils\");\nconst assertValidationError_1 = require(\"../../../../errors/utils/assertValidationError\");\nconst validation_1 = require(\"../../../../errors/types/validation\");\nconst constants_1 = require(\"../../utils/constants\");\nconst byteLength_1 = require(\"./byteLength\");\nconst putObjectJob_1 = require(\"./putObjectJob\");\nconst multipart_1 = require(\"./multipart\");\nfunction uploadData(input) {\n    const { data } = input;\n    const dataByteLength = (0, byteLength_1.byteLength)(data);\n    (0, assertValidationError_1.assertValidationError)(dataByteLength === undefined || dataByteLength <= constants_1.MAX_OBJECT_SIZE, validation_1.StorageValidationErrorCode.ObjectIsTooLarge);\n    if (dataByteLength && dataByteLength <= constants_1.DEFAULT_PART_SIZE) {\n        // Single part upload\n        const abortController = new AbortController();\n        return (0, utils_1.createUploadTask)({\n            isMultipartUpload: false,\n            job: (0, putObjectJob_1.putObjectJob)(input, abortController.signal, dataByteLength),\n            onCancel: (message) => {\n                abortController.abort(message);\n            },\n        });\n    }\n    else {\n        // Multipart upload\n        const { multipartUploadJob, onPause, onResume, onCancel } = (0, multipart_1.getMultipartUploadHandlers)(input, dataByteLength);\n        return (0, utils_1.createUploadTask)({\n            isMultipartUpload: true,\n            job: multipartUploadJob,\n            onCancel: (message) => {\n                onCancel(message);\n            },\n            onPause,\n            onResume,\n        });\n    }\n}\nexports.uploadData = uploadData;\n"],"names":[],"mappings":";;AACA;AACA;AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AAC9D,OAAO,CAAC,UAAU,GAAG,KAAK,CAAC,CAAC;AAC5B,MAAM,OAAO,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;AACvC,MAAM,uBAAuB,GAAG,OAAO,CAAC,gDAAgD,CAAC,CAAC;AAC1F,MAAM,YAAY,GAAG,OAAO,CAAC,qCAAqC,CAAC,CAAC;AACpE,MAAM,WAAW,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAC;AACrD,MAAM,YAAY,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;AAC7C,MAAM,cAAc,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC;AACjD,MAAM,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC;AAC3C,SAAS,UAAU,CAAC,KAAK,EAAE;AAC3B,IAAI,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;AAC3B,IAAI,MAAM,cAAc,GAAG,IAAI,YAAY,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AAC9D,IAAI,IAAI,uBAAuB,CAAC,qBAAqB,EAAE,cAAc,KAAK,SAAS,IAAI,cAAc,IAAI,WAAW,CAAC,eAAe,EAAE,YAAY,CAAC,0BAA0B,CAAC,gBAAgB,CAAC,CAAC;AAChM,IAAI,IAAI,cAAc,IAAI,cAAc,IAAI,WAAW,CAAC,iBAAiB,EAAE;AAC3E;AACA,QAAQ,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE,CAAC;AACtD,QAAQ,OAAO,IAAI,OAAO,CAAC,gBAAgB,EAAE;AAC7C,YAAY,iBAAiB,EAAE,KAAK;AACpC,YAAY,GAAG,EAAE,IAAI,cAAc,CAAC,YAAY,EAAE,KAAK,EAAE,eAAe,CAAC,MAAM,EAAE,cAAc,CAAC;AAChG,YAAY,QAAQ,EAAE,CAAC,OAAO,KAAK;AACnC,gBAAgB,eAAe,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AAC/C,aAAa;AACb,SAAS,CAAC,CAAC;AACX,KAAK;AACL,SAAS;AACT;AACA,QAAQ,MAAM,EAAE,kBAAkB,EAAE,OAAO,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,IAAI,WAAW,CAAC,0BAA0B,EAAE,KAAK,EAAE,cAAc,CAAC,CAAC;AACvI,QAAQ,OAAO,IAAI,OAAO,CAAC,gBAAgB,EAAE;AAC7C,YAAY,iBAAiB,EAAE,IAAI;AACnC,YAAY,GAAG,EAAE,kBAAkB;AACnC,YAAY,QAAQ,EAAE,CAAC,OAAO,KAAK;AACnC,gBAAgB,QAAQ,CAAC,OAAO,CAAC,CAAC;AAClC,aAAa;AACb,YAAY,OAAO;AACnB,YAAY,QAAQ;AACpB,SAAS,CAAC,CAAC;AACX,KAAK;AACL,CAAC;AACD,OAAO,CAAC,UAAU,GAAG,UAAU;;"}