@aws-amplify/core 5.3.2-unstable.ffe65ea.1 → 5.4.0

package/lib-esm/clients/handlers/fetch.js

@@ -0,0 +1,119 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+import 'isomorphic-unfetch'; // TODO: remove this dependency in v6
+var shouldSendBody = function (method) {
+    return !['HEAD', 'GET', 'DELETE'].includes(method.toUpperCase());
+};
+export var fetchTransferHandler = function (_a, _b) {
+    var url = _a.url, method = _a.method, headers = _a.headers, body = _a.body;
+    var abortSignal = _b.abortSignal;
+    return __awaiter(void 0, void 0, void 0, function () {
+        var resp, e_1, responseHeaders, httpResponse, bodyWithMixin;
+        var _c, _d;
+        return __generator(this, function (_e) {
+            switch (_e.label) {
+                case 0:
+                    _e.trys.push([0, 2, , 3]);
+                    return [4 /*yield*/, fetch(url, {
+                            method: method,
+                            headers: headers,
+                            body: shouldSendBody(method) ? body : undefined,
+                            signal: abortSignal,
+                        })];
+                case 1:
+                    resp = _e.sent();
+                    return [3 /*break*/, 3];
+                case 2:
+                    e_1 = _e.sent();
+                    // TODO: needs to revise error handling in v6
+                    // For now this is a thin wrapper over original fetch error similar to cognito-identity-js package.
+                    // Ref: https://github.com/aws-amplify/amplify-js/blob/4fbc8c0a2be7526aab723579b4c95b552195a80b/packages/amazon-cognito-identity-js/src/Client.js#L103-L108
+                    if (e_1 instanceof TypeError) {
+                        throw new Error('Network error');
+                    }
+                    throw e_1;
+                case 3:
+                    responseHeaders = {};
+                    (_c = resp.headers) === null || _c === void 0 ? void 0 : _c.forEach(function (value, key) {
+                        responseHeaders[key.toLowerCase()] = value;
+                    });
+                    httpResponse = {
+                        statusCode: resp.status,
+                        headers: responseHeaders,
+                        body: null,
+                    };
+                    bodyWithMixin = Object.assign((_d = resp.body) !== null && _d !== void 0 ? _d : {}, {
+                        text: withMemoization(function () { return resp.text(); }),
+                        blob: withMemoization(function () { return resp.blob(); }),
+                        json: withMemoization(function () { return resp.json(); }),
+                    });
+                    return [2 /*return*/, __assign(__assign({}, httpResponse), { body: bodyWithMixin })];
+            }
+        });
+    });
+};
+/**
+ * Cache the payload of a response body. It allows multiple calls to the body,
+ * for example, when reading the body in both retry decider and error deserializer.
+ * Caching body is allowed here because we call the body accessor(blob(), json(),
+ * etc.) when body is small or streaming implementation is not available(RN).
+ */
+var withMemoization = function (payloadAccessor) {
+    var cached;
+    return function () {
+        if (!cached) {
+            // Explicitly not awaiting. Intermediate await would add overhead and
+            // introduce a possible race in the event that this wrapper is called
+            // again before the first `payloadAccessor` call resolves.
+            cached = payloadAccessor();
+        }
+        return cached;
+    };
+};

package/lib-esm/clients/handlers/unauthenticated.d.ts

@@ -0,0 +1,4 @@
+import { RetryOptions } from '../middleware/retry';
+import { UserAgentOptions } from '../middleware/userAgent';
+import { HttpRequest, HttpResponse } from '../types';
+export declare const unauthenticatedHandler: (request: HttpRequest, options: UserAgentOptions & RetryOptions<HttpResponse>) => Promise<HttpResponse>;

package/lib-esm/clients/handlers/unauthenticated.js

@@ -0,0 +1,7 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { retryMiddleware } from '../middleware/retry';
+import { userAgentMiddleware } from '../middleware/userAgent';
+import { composeTransferHandler } from '../internal/composeTransferHandler';
+import { fetchTransferHandler } from './fetch';
+export var unauthenticatedHandler = composeTransferHandler(fetchTransferHandler, [userAgentMiddleware, retryMiddleware]);

package/lib-esm/clients/index.d.ts

@@ -0,0 +1,8 @@
+export { getDnsSuffix } from './endpoints';
+export { fetchTransferHandler } from './handlers/fetch';
+export { unauthenticatedHandler } from './handlers/unauthenticated';
+export { authenticatedHandler } from './handlers/authenticated';
+export { composeServiceApi } from './internal/composeServiceApi';
+export { signRequest, presignUrl, } from './middleware/signing/signer/signatureV4';
+export { parseJsonBody, parseJsonError, parseMetadata } from './serde';
+export * from './types';

package/lib-esm/clients/index.js

@@ -0,0 +1,10 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+export { getDnsSuffix } from './endpoints';
+export { fetchTransferHandler } from './handlers/fetch';
+export { unauthenticatedHandler } from './handlers/unauthenticated';
+export { authenticatedHandler } from './handlers/authenticated';
+export { composeServiceApi } from './internal/composeServiceApi';
+export { signRequest, presignUrl, } from './middleware/signing/signer/signatureV4';
+export { parseJsonBody, parseJsonError, parseMetadata } from './serde';
+export * from './types';

package/lib-esm/clients/internal/composeServiceApi.d.ts

@@ -0,0 +1,8 @@
+import { ServiceClientOptions } from '../types/aws';
+import { TransferHandler, Endpoint } from '../types/core';
+import { HttpRequest, HttpResponse } from '../types/http';
+export declare const composeServiceApi: <TransferHandlerOptions, Input, Output, DefaultConfig extends Partial<TransferHandlerOptions & ServiceClientOptions>>(transferHandler: TransferHandler<HttpRequest, HttpResponse, TransferHandlerOptions>, serializer: (input: Input, endpoint: Endpoint) => HttpRequest, deserializer: (output: HttpResponse) => Promise<Output>, defaultConfig: DefaultConfig) => (config: OptionalizeKey<TransferHandlerOptions & ServiceClientOptions, keyof DefaultConfig>, input: Input) => Promise<Output>;
+type OptionalizeKey<T, K> = Omit<T, K & keyof T> & {
+    [P in K & keyof T]?: T[P];
+};
+export {};

package/lib-esm/clients/internal/composeServiceApi.js

@@ -0,0 +1,71 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+export var composeServiceApi = function (transferHandler, serializer, deserializer, defaultConfig) {
+    return function (config, input) { return __awaiter(void 0, void 0, void 0, function () {
+        var resolvedConfig, endpoint, request, response;
+        return __generator(this, function (_a) {
+            switch (_a.label) {
+                case 0:
+                    resolvedConfig = __assign(__assign({}, defaultConfig), config);
+                    return [4 /*yield*/, resolvedConfig.endpointResolver({
+                            region: resolvedConfig.region,
+                        })];
+                case 1:
+                    endpoint = _a.sent();
+                    request = serializer(input, endpoint);
+                    return [4 /*yield*/, transferHandler(request, __assign({}, resolvedConfig))];
+                case 2:
+                    response = _a.sent();
+                    return [4 /*yield*/, deserializer(response)];
+                case 3: return [2 /*return*/, _a.sent()];
+            }
+        });
+    }); };
+};

package/lib-esm/clients/internal/composeTransferHandler.d.ts

@@ -0,0 +1,29 @@
+import { Middleware, TransferHandler, Request as RequestBase, Response as ResponseBase } from '../types';
+/**
+ * Compose a transfer handler with a core transfer handler and a list of middleware.
+ * @param coreHandler Core transfer handler
+ * @param middleware	List of middleware
+ * @returns A transfer handler whose option type is the union of the core
+ * 	transfer handler's option type and the middleware's option type.
+ * @internal
+ */
+export declare const composeTransferHandler: <MiddlewareOptionsArr extends any[] = [], Request_1 extends RequestBase = RequestBase, Response_1 extends ResponseBase = ResponseBase, CoreHandler extends TransferHandler<Request_1, Response_1, any> = TransferHandler<Request_1, Response_1, {}>>(coreHandler: CoreHandler, middleware: OptionToMiddleware<Request_1, Response_1, MiddlewareOptionsArr>) => (request: Request_1, options: MergeNoConflictKeys<[...MiddlewareOptionsArr, InferOptionTypeFromTransferHandler<CoreHandler>]>) => Promise<Response_1>;
+/**
+ * Type to convert a middleware option type to a middleware type with the given
+ * option type.
+ */
+type OptionToMiddleware<Request extends RequestBase, Response extends ResponseBase, Options extends any[]> = Options extends [] ? [] : Options extends [infer LastOption] ? [Middleware<Request, Response, LastOption>] : Options extends [infer FirstOption, ...infer RestOptions] ? [
+    Middleware<Request, Response, FirstOption>,
+    ...OptionToMiddleware<Request, Response, RestOptions>
+] : never;
+/**
+ * Type to intersect multiple types if they have no conflict keys.
+ */
+type MergeNoConflictKeys<Options extends any[]> = Options extends [
+    infer OnlyOption
+] ? OnlyOption : Options extends [infer FirstOption, infer SecondOption] ? FirstOption & SecondOption : Options extends [infer FirstOption, ...infer RestOptions] ? FirstOption & MergeNoConflictKeys<RestOptions> : never;
+/**
+ * Type to infer the option type of a transfer handler type.
+ */
+type InferOptionTypeFromTransferHandler<T extends TransferHandler<any, any, any>> = Parameters<T>[1];
+export {};

package/lib-esm/clients/internal/composeTransferHandler.js

@@ -0,0 +1,22 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * Compose a transfer handler with a core transfer handler and a list of middleware.
+ * @param coreHandler Core transfer handler
+ * @param middleware	List of middleware
+ * @returns A transfer handler whose option type is the union of the core
+ * 	transfer handler's option type and the middleware's option type.
+ * @internal
+ */
+export var composeTransferHandler = function (coreHandler, middleware) {
+    return function (request, options) {
+        var context = {};
+        var composedHandler = function (request) { return coreHandler(request, options); };
+        for (var i = middleware.length - 1; i >= 0; i--) {
+            var m = middleware[i];
+            var resolvedMiddleware = m(options);
+            composedHandler = resolvedMiddleware(composedHandler, context);
+        }
+        return composedHandler(request);
+    };
+};

package/lib-esm/clients/middleware/retry/defaultRetryDecider.d.ts

@@ -0,0 +1,6 @@
+import { HttpResponse, ErrorParser } from '../../types';
+/**
+ * Get retry decider function
+ * @param errorParser Function to load JavaScript error from HTTP response
+ */
+export declare const getRetryDecider: (errorParser: ErrorParser) => (response?: HttpResponse, error?: Error) => Promise<boolean>;

package/lib-esm/clients/middleware/retry/defaultRetryDecider.js

@@ -0,0 +1,97 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+import { isClockSkewError } from '../../utils/isClockSkewError';
+/**
+ * Get retry decider function
+ * @param errorParser Function to load JavaScript error from HTTP response
+ */
+export var getRetryDecider = function (errorParser) {
+    return function (response, error) { return __awaiter(void 0, void 0, void 0, function () {
+        var errorCode, _a, statusCode;
+        var _b;
+        return __generator(this, function (_c) {
+            switch (_c.label) {
+                case 0:
+                    if (!(error !== null && error !== void 0)) return [3 /*break*/, 1];
+                    _a = error;
+                    return [3 /*break*/, 3];
+                case 1: return [4 /*yield*/, errorParser(response)];
+                case 2:
+                    _a = (_c.sent());
+                    _c.label = 3;
+                case 3:
+                    errorCode = ((_b = _a) !== null && _b !== void 0 ? _b : {}).name;
+                    statusCode = response === null || response === void 0 ? void 0 : response.statusCode;
+                    return [2 /*return*/, (isConnectionError(error) ||
+                            isThrottlingError(statusCode, errorCode) ||
+                            isClockSkewError(errorCode) ||
+                            isServerSideError(statusCode, errorCode))];
+            }
+        });
+    }); };
+};
+// reference: https://github.com/aws/aws-sdk-js-v3/blob/ab0e7be36e7e7f8a0c04834357aaad643c7912c3/packages/service-error-classification/src/constants.ts#L22-L37
+var THROTTLING_ERROR_CODES = [
+    'BandwidthLimitExceeded',
+    'EC2ThrottledException',
+    'LimitExceededException',
+    'PriorRequestNotComplete',
+    'ProvisionedThroughputExceededException',
+    'RequestLimitExceeded',
+    'RequestThrottled',
+    'RequestThrottledException',
+    'SlowDown',
+    'ThrottledException',
+    'Throttling',
+    'ThrottlingException',
+    'TooManyRequestsException',
+];
+var TIMEOUT_ERROR_CODES = [
+    'TimeoutError',
+    'RequestTimeout',
+    'RequestTimeoutException',
+];
+var isThrottlingError = function (statusCode, errorCode) {
+    return statusCode === 429 || THROTTLING_ERROR_CODES.includes(errorCode);
+};
+var isConnectionError = function (error) { return (error === null || error === void 0 ? void 0 : error.name) === 'Network error'; };
+var isServerSideError = function (statusCode, errorCode) {
+    return [500, 502, 503, 504].includes(statusCode) ||
+        TIMEOUT_ERROR_CODES.includes(errorCode);
+};

package/lib-esm/clients/middleware/retry/index.d.ts

@@ -0,0 +1,3 @@
+export { RetryOptions, retryMiddleware } from './middleware';
+export { jitteredBackoff } from './jitteredBackoff';
+export { getRetryDecider } from './defaultRetryDecider';

package/lib-esm/clients/middleware/retry/index.js

@@ -0,0 +1,5 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+export { retryMiddleware } from './middleware';
+export { jitteredBackoff } from './jitteredBackoff';
+export { getRetryDecider } from './defaultRetryDecider';

package/lib-esm/clients/middleware/retry/jitteredBackoff.d.ts

@@ -0,0 +1,2 @@
+import type { RetryOptions } from './middleware';
+export declare const jitteredBackoff: RetryOptions['computeDelay'];

package/lib-esm/clients/middleware/retry/jitteredBackoff.js

@@ -0,0 +1,12 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+// TODO: [v6] The separate retry utility is used by Data packages now and will replaced by retry middleware.
+import { jitteredBackoff as jitteredBackoffUtil } from '../../../Util/Retry';
+var DEFAULT_MAX_DELAY_MS = 5 * 60 * 1000;
+export var jitteredBackoff = function (attempt) {
+    var delayFunction = jitteredBackoffUtil(DEFAULT_MAX_DELAY_MS);
+    var delay = delayFunction(attempt);
+    // The delayFunction returns false when the delay is greater than the max delay(5 mins).
+    // In this case, the retry middleware will delay 5 mins instead, as a ceiling of the delay.
+    return delay === false ? DEFAULT_MAX_DELAY_MS : delay;
+};

package/lib-esm/clients/middleware/retry/middleware.d.ts

@@ -0,0 +1,40 @@
+import { MetadataBearer } from '@aws-sdk/types';
+import { MiddlewareContext, MiddlewareHandler, Request, Response } from '../../types/core';
+/**
+ * Configuration of the retry middleware
+ */
+export interface RetryOptions<TResponse = Response> {
+    /**
+     * Function to decide if the request should be retried.
+     *
+     * @param response Optional response of the request.
+     * @param error Optional error thrown from previous attempts.
+     * @returns True if the request should be retried.
+     */
+    retryDecider: (response?: TResponse, error?: unknown) => Promise<boolean>;
+    /**
+     * Function to compute the delay in milliseconds before the next retry based
+     * on the number of attempts.
+     * @param attempt Current number of attempts, including the first attempt.
+     * @returns Delay in milliseconds.
+     */
+    computeDelay: (attempt: number) => number;
+    /**
+     * Maximum number of retry attempts, starting from 1. Defaults to 3.
+     */
+    maxAttempts?: number;
+    /**
+     * Optional AbortSignal to abort the retry attempts.
+     */
+    abortSignal?: AbortSignal;
+}
+/**
+ * Retry middleware
+ */
+export declare const retryMiddleware: <TInput = Request, TOutput = Response>({ maxAttempts, retryDecider, computeDelay, abortSignal, }: RetryOptions<TOutput>) => (next: MiddlewareHandler<TInput, TOutput>, context: MiddlewareContext) => (request: TInput) => Promise<TOutput>;
+/**
+ * Check if the response is a contains `$metadata` property.
+ *
+ * @internal Amplify internal use only
+ */
+export declare const isMetadataBearer: (response: unknown) => response is MetadataBearer;

package/lib-esm/clients/middleware/retry/middleware.js

@@ -0,0 +1,138 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g;
+    return g = { next: verb(0), "throw": verb(1), "return": verb(2) }, typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
+var DEFAULT_RETRY_ATTEMPTS = 3;
+/**
+ * Retry middleware
+ */
+export var retryMiddleware = function (_a) {
+    var _b = _a.maxAttempts, maxAttempts = _b === void 0 ? DEFAULT_RETRY_ATTEMPTS : _b, retryDecider = _a.retryDecider, computeDelay = _a.computeDelay, abortSignal = _a.abortSignal;
+    if (maxAttempts < 1) {
+        throw new Error('maxAttempts must be greater than 0');
+    }
+    return function (next, context) {
+        return function retryMiddleware(request) {
+            var _a;
+            return __awaiter(this, void 0, void 0, function () {
+                var error, attemptsCount, response, e_1, delay;
+                return __generator(this, function (_b) {
+                    switch (_b.label) {
+                        case 0:
+                            attemptsCount = (_a = context.attemptsCount) !== null && _a !== void 0 ? _a : 0;
+                            _b.label = 1;
+                        case 1:
+                            if (!(!(abortSignal === null || abortSignal === void 0 ? void 0 : abortSignal.aborted) && attemptsCount < maxAttempts)) return [3 /*break*/, 11];
+                            error = undefined;
+                            response = undefined;
+                            _b.label = 2;
+                        case 2:
+                            _b.trys.push([2, 4, , 5]);
+                            return [4 /*yield*/, next(request)];
+                        case 3:
+                            response = _b.sent();
+                            return [3 /*break*/, 5];
+                        case 4:
+                            e_1 = _b.sent();
+                            error = e_1;
+                            return [3 /*break*/, 5];
+                        case 5:
+                            // context.attemptsCount may be updated after calling next handler which may retry the request by itself.
+                            attemptsCount =
+                                context.attemptsCount > attemptsCount
+                                    ? context.attemptsCount
+                                    : attemptsCount + 1;
+                            context.attemptsCount = attemptsCount;
+                            return [4 /*yield*/, retryDecider(response, error)];
+                        case 6:
+                            if (!_b.sent()) return [3 /*break*/, 9];
+                            if (!(!(abortSignal === null || abortSignal === void 0 ? void 0 : abortSignal.aborted) && attemptsCount < maxAttempts)) return [3 /*break*/, 8];
+                            delay = computeDelay(attemptsCount);
+                            return [4 /*yield*/, cancellableSleep(delay, abortSignal)];
+                        case 7:
+                            _b.sent();
+                            _b.label = 8;
+                        case 8: return [3 /*break*/, 1];
+                        case 9:
+                            if (response) {
+                                updateMetadataAttempts(response, attemptsCount);
+                                return [2 /*return*/, response];
+                            }
+                            else {
+                                updateMetadataAttempts(error, attemptsCount);
+                                throw error;
+                            }
+                            _b.label = 10;
+                        case 10: return [3 /*break*/, 1];
+                        case 11: throw (abortSignal === null || abortSignal === void 0 ? void 0 : abortSignal.aborted)
+                            ? new Error('Request aborted')
+                            : error !== null && error !== void 0 ? error : new Error('Retry attempts exhausted');
+                    }
+                });
+            });
+        };
+    };
+};
+var cancellableSleep = function (timeoutMs, abortSignal) {
+    if (abortSignal === null || abortSignal === void 0 ? void 0 : abortSignal.aborted) {
+        return Promise.resolve();
+    }
+    var timeoutId;
+    var sleepPromiseResolveFn;
+    var sleepPromise = new Promise(function (resolve) {
+        sleepPromiseResolveFn = resolve;
+        timeoutId = setTimeout(resolve, timeoutMs);
+    });
+    abortSignal === null || abortSignal === void 0 ? void 0 : abortSignal.addEventListener('abort', function cancelSleep(event) {
+        clearTimeout(timeoutId);
+        abortSignal === null || abortSignal === void 0 ? void 0 : abortSignal.removeEventListener('abort', cancelSleep);
+        sleepPromiseResolveFn();
+    });
+    return sleepPromise;
+};
+/**
+ * Check if the response is a contains `$metadata` property.
+ *
+ * @internal Amplify internal use only
+ */
+export var isMetadataBearer = function (response) { return typeof (response === null || response === void 0 ? void 0 : response['$metadata']) === 'object'; };
+var updateMetadataAttempts = function (nextHandlerOutput, attempts) {
+    if (isMetadataBearer(nextHandlerOutput)) {
+        nextHandlerOutput.$metadata.attempts = attempts;
+    }
+    nextHandlerOutput['$metadata'] = { attempts: attempts };
+};

package/lib-esm/clients/middleware/signing/index.d.ts

@@ -0,0 +1 @@
+export { signingMiddleware, SigningOptions } from './middleware';

package/lib-esm/clients/middleware/signing/index.js

@@ -0,0 +1,3 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+export { signingMiddleware } from './middleware';

package/lib-esm/clients/middleware/signing/middleware.d.ts

@@ -0,0 +1,13 @@
+import { Credentials, HttpRequest, HttpResponse, MiddlewareHandler } from '../../types';
+/**
+ * Configuration of the signing middleware
+ */
+export interface SigningOptions {
+    credentials: Credentials;
+    region: string;
+    service: string;
+}
+/**
+ * Middleware that SigV4 signs request with AWS credentials, and correct system clock offset.
+ */
+export declare const signingMiddleware: ({ credentials, region, service, }: SigningOptions) => (next: MiddlewareHandler<HttpRequest, HttpResponse>) => (request: HttpRequest) => Promise<HttpResponse>;