@aws-amplify/api-rest 4.0.1-console-preview.b5a42af.0 → 4.0.1-console-preview.9607e4a.0

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

@@ -1,17 +1,20 @@
 import { DocumentType } from '@aws-amplify/core/internals/utils';
-export type GetOptions = RestApiOptionsBase;
-export type PostOptions = RestApiOptionsBase;
-export type PutOptions = RestApiOptionsBase;
-export type PatchOptions = RestApiOptionsBase;
-export type DeleteOptions = Omit<RestApiOptionsBase, 'body'>;
-export type HeadOptions = Omit<RestApiOptionsBase, 'body'>;
+export type GetInput = ApiInput<RestApiOptionsBase>;
+export type PostInput = ApiInput<RestApiOptionsBase>;
+export type PutInput = ApiInput<RestApiOptionsBase>;
+export type PatchInput = ApiInput<RestApiOptionsBase>;
+export type DeleteInput = ApiInput<Omit<RestApiOptionsBase, 'body'>>;
+export type HeadInput = ApiInput<Omit<RestApiOptionsBase, 'body'>>;
 export type GetOperation = Operation<RestApiResponse>;
 export type PostOperation = Operation<RestApiResponse>;
 export type PutOperation = Operation<RestApiResponse>;
 export type PatchOperation = Operation<RestApiResponse>;
 export type DeleteOperation = Operation<Omit<RestApiResponse, 'body'>>;
 export type HeadOperation = Operation<Omit<RestApiResponse, 'body'>>;
-type RestApiOptionsBase = {
+/**
+ * @internal
+ */
+export type RestApiOptionsBase = {
     headers?: Headers;
     queryParams?: Record<string, string>;
     body?: DocumentType | FormData;
@@ -54,12 +57,20 @@ export interface RestApiResponse {
     headers: Headers;
 }
 /**
- * Input type of REST API.
  * @internal
  */
 export type ApiInput<Options> = {
+    /**
+     * Name of the REST API configured in Amplify singleton.
+     */
     apiName: string;
+    /**
+     * Path of the REST API.
+     */
     path: string;
+    /**
+     * Options to overwrite the REST API call behavior.
+     */
     options?: Options;
 };
 /**

package/lib-esm/utils/createCancellableOperation.d.ts

@@ -1,4 +1,5 @@
 import { HttpResponse } from '@aws-amplify/core/internals/aws-client-utils';
+import { Operation } from '../types';
 /**
  * Create a cancellable operation conforming to the internal POST API interface.
  * @internal
@@ -8,4 +9,4 @@ export declare function createCancellableOperation(handler: () => Promise<HttpRe
  * Create a cancellable operation conforming to the external REST API interface.
  * @internal
  */
-export declare function createCancellableOperation(handler: (signal: AbortSignal) => Promise<HttpResponse>): Promise<HttpResponse>;
+export declare function createCancellableOperation(handler: (signal: AbortSignal) => Promise<HttpResponse>): Operation<HttpResponse>;

package/lib-esm/utils/createCancellableOperation.js

@@ -1,42 +1,52 @@
 // Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 // SPDX-License-Identifier: Apache-2.0
-import { __assign, __awaiter, __generator } from "tslib";
-import { CancelledError, RestApiError } from '../errors';
+import { __awaiter, __generator } from "tslib";
+import { CancelledError } from '../errors';
 import { parseRestApiServiceError } from './serviceError';
+import { logger } from './logger';
 /**
  * @internal
  */
 export function createCancellableOperation(handler, abortController) {
     var _this = this;
     var isInternalPost = function (handler) { return !!abortController; };
-    var signal = abortController === null || abortController === void 0 ? void 0 : abortController.signal;
+    // For creating a cancellable operation for public REST APIs, we need to create an AbortController
+    // internally. Whereas for internal POST APIs, we need to accept in the AbortController from the
+    // callers.
+    var publicApisAbortController = new AbortController();
+    var publicApisAbortSignal = publicApisAbortController.signal;
+    var internalPostAbortSignal = abortController === null || abortController === void 0 ? void 0 : abortController.signal;
     var job = function () { return __awaiter(_this, void 0, void 0, function () {
-        var response, error_1;
+        var response, error_1, abortSignal, cancelledError;
         var _a;
         return __generator(this, function (_b) {
             switch (_b.label) {
                 case 0:
-                    _b.trys.push([0, 2, , 3]);
+                    _b.trys.push([0, 4, , 5]);
                     return [4 /*yield*/, (isInternalPost(handler)
                             ? handler()
-                            : handler(signal))];
+                            : handler(publicApisAbortSignal))];
                 case 1:
                     response = _b.sent();
-                    if (response.statusCode >= 300) {
-                        throw parseRestApiServiceError(response);
-                    }
-                    return [2 /*return*/, response];
-                case 2:
+                    if (!(response.statusCode >= 300)) return [3 /*break*/, 3];
+                    return [4 /*yield*/, parseRestApiServiceError(response)];
+                case 2: throw _b.sent();
+                case 3: return [2 /*return*/, response];
+                case 4:
                     error_1 = _b.sent();
-                    if (error_1.name === 'AbortError' || (signal === null || signal === void 0 ? void 0 : signal.aborted) === true) {
-                        throw new CancelledError({
+                    abortSignal = internalPostAbortSignal !== null && internalPostAbortSignal !== void 0 ? internalPostAbortSignal : publicApisAbortSignal;
+                    if (error_1.name === 'AbortError' || (abortSignal === null || abortSignal === void 0 ? void 0 : abortSignal.aborted) === true) {
+                        cancelledError = new CancelledError({
                             name: error_1.name,
-                            message: (_a = signal.reason) !== null && _a !== void 0 ? _a : error_1.message,
+                            message: (_a = abortSignal.reason) !== null && _a !== void 0 ? _a : error_1.message,
                             underlyingError: error_1,
                         });
+                        logger.debug(error_1);
+                        throw cancelledError;
                     }
-                    throw new RestApiError(__assign(__assign({}, error_1), { underlyingError: error_1 }));
-                case 3: return [2 /*return*/];
+                    logger.debug(error_1);
+                    throw error_1;
+                case 5: return [2 /*return*/];
             }
         });
     }); };
@@ -45,15 +55,15 @@ export function createCancellableOperation(handler, abortController) {
     }
     else {
         var cancel = function (abortMessage) {
-            if ((signal === null || signal === void 0 ? void 0 : signal.aborted) === true) {
+            if (publicApisAbortSignal.aborted === true) {
                 return;
             }
-            abortController === null || abortController === void 0 ? void 0 : abortController.abort(abortMessage);
+            publicApisAbortController.abort(abortMessage);
             // Abort reason is not widely support enough across runtimes and and browsers, so we set it
             // if it is not already set.
-            if ((signal === null || signal === void 0 ? void 0 : signal.reason) !== abortMessage) {
-                // @ts-expect-error reason is a readonly property
-                signal['reason'] = abortMessage;
+            if (publicApisAbortSignal.reason !== abortMessage) {
+                publicApisAbortSignal['reason'] =
+                    abortMessage;
             }
         };
         return { response: job(), cancel: cancel };

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

@@ -1,4 +1,6 @@
 export { createCancellableOperation } from './createCancellableOperation';
 export { resolveCredentials } from './resolveCredentials';
-export { parseUrl } from './parseUrl';
+export { parseSigningInfo } from './parseSigningInfo';
 export { parseRestApiServiceError } from './serviceError';
+export { resolveApiUrl } from './resolveApiUrl';
+export { logger } from './logger';

package/lib-esm/utils/index.js

@@ -2,5 +2,7 @@
 // SPDX-License-Identifier: Apache-2.0
 export { createCancellableOperation } from './createCancellableOperation';
 export { resolveCredentials } from './resolveCredentials';
-export { parseUrl } from './parseUrl';
+export { parseSigningInfo } from './parseSigningInfo';
 export { parseRestApiServiceError } from './serviceError';
+export { resolveApiUrl } from './resolveApiUrl';
+export { logger } from './logger';

package/lib-esm/utils/index.native.d.ts

@@ -0,0 +1,6 @@
+export { createCancellableOperation } from './createCancellableOperation';
+export { resolveCredentials } from './resolveCredentials';
+export { parseSigningInfo } from './parseSigningInfo';
+export { parseRestApiServiceError } from './serviceError';
+export { resolveApiUrl } from './resolveApiUrl';
+export { logger } from './logger';

package/lib-esm/utils/index.native.js

@@ -0,0 +1,10 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { loadUrlPolyfill } from '@aws-amplify/react-native';
+loadUrlPolyfill();
+export { createCancellableOperation } from './createCancellableOperation';
+export { resolveCredentials } from './resolveCredentials';
+export { parseSigningInfo } from './parseSigningInfo';
+export { parseRestApiServiceError } from './serviceError';
+export { resolveApiUrl } from './resolveApiUrl';
+export { logger } from './logger';

package/lib-esm/utils/logger.d.ts

@@ -0,0 +1,2 @@
+import { Logger } from '@aws-amplify/core/internals/utils';
+export declare const logger: Logger;

package/lib-esm/utils/logger.js

@@ -0,0 +1,4 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { Logger } from '@aws-amplify/core/internals/utils';
+export var logger = new Logger('RestApis');

package/lib-esm/utils/normalizeHeaders.d.ts

@@ -1 +1 @@
-export declare const normalizeHeaders: (headers: Record<string, string>) => Record<string, string>;
+export declare const normalizeHeaders: (headers?: Record<string, string>) => Record<string, string>;

package/lib-esm/utils/parseSigningInfo.d.ts

@@ -0,0 +1,14 @@
+import { AmplifyClassV6 } from '@aws-amplify/core';
+/**
+ * Infer the signing service and region from the given URL, and for REST API only, from the Amplify configuration.
+ * It supports raw API Gateway endpoint and AppSync endpoint.
+ *
+ * @internal
+ */
+export declare const parseSigningInfo: (url: URL, restApiOptions?: {
+    amplify: AmplifyClassV6;
+    apiName: string;
+}) => {
+    service: string;
+    region: string;
+};

package/lib-esm/utils/parseSigningInfo.js

@@ -0,0 +1,38 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { __read } from "tslib";
+import { APIG_HOSTNAME_PATTERN, DEFAULT_IAM_SIGNING_REGION, DEFAULT_REST_IAM_SIGNING_SERVICE, } from './constants';
+/**
+ * Infer the signing service and region from the given URL, and for REST API only, from the Amplify configuration.
+ * It supports raw API Gateway endpoint and AppSync endpoint.
+ *
+ * @internal
+ */
+export var parseSigningInfo = function (url, restApiOptions) {
+    var _a, _b, _c, _d, _e;
+    var _f = (_d = (_c = (_b = (_a = restApiOptions === null || restApiOptions === void 0 ? void 0 : restApiOptions.amplify.getConfig()) === null || _a === void 0 ? void 0 : _a.API) === null || _b === void 0 ? void 0 : _b.REST) === null || _c === void 0 ? void 0 : _c[restApiOptions === null || restApiOptions === void 0 ? void 0 : restApiOptions.apiName]) !== null && _d !== void 0 ? _d : {}, _g = _f.service, signingService = _g === void 0 ? DEFAULT_REST_IAM_SIGNING_SERVICE : _g, _h = _f.region, signingRegion = _h === void 0 ? DEFAULT_IAM_SIGNING_REGION : _h;
+    var hostname = url.hostname;
+    var _j = __read((_e = APIG_HOSTNAME_PATTERN.exec(hostname)) !== null && _e !== void 0 ? _e : [], 3), service = _j[1], region = _j[2];
+    if (service === DEFAULT_REST_IAM_SIGNING_SERVICE) {
+        // The configured endpoint is an API Gateway endpoint
+        // @see: https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-call-api.html
+        return {
+            service: service,
+            region: region !== null && region !== void 0 ? region : signingRegion,
+        };
+    }
+    else if (service === 'appsync-api') {
+        // AppSync endpoint is internally supported because GraphQL operation will send request using POST handler.
+        // example: https://xxxx.appsync-api.us-east-1.amazonaws.com/graphql
+        return {
+            service: 'appsync',
+            region: region !== null && region !== void 0 ? region : signingRegion,
+        };
+    }
+    else {
+        return {
+            service: signingService,
+            region: signingRegion,
+        };
+    }
+};

package/lib-esm/utils/resolveApiUrl.d.ts

@@ -0,0 +1,12 @@
+import { AmplifyClassV6 } from '@aws-amplify/core';
+/**
+ * Resolve the REST API request URL by:
+ * 1. Loading the REST API endpoint from the Amplify configuration with corresponding API name.
+ * 2. Appending the path to the endpoint.
+ * 3. Merge the query parameters from path and the queryParameter argument which is taken from the public REST API
+ *   options.
+ * 4. Validating the resulting URL string.
+ *
+ * @internal
+ */
+export declare const resolveApiUrl: (amplify: AmplifyClassV6, apiName: string, path: string, queryParams?: Record<string, string>) => URL;

package/lib-esm/utils/resolveApiUrl.js

@@ -0,0 +1,34 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+import { __assign, __read } from "tslib";
+import { RestApiError, RestApiValidationErrorCode, assertValidationError, validationErrorMap, } from '../errors';
+/**
+ * Resolve the REST API request URL by:
+ * 1. Loading the REST API endpoint from the Amplify configuration with corresponding API name.
+ * 2. Appending the path to the endpoint.
+ * 3. Merge the query parameters from path and the queryParameter argument which is taken from the public REST API
+ *   options.
+ * 4. Validating the resulting URL string.
+ *
+ * @internal
+ */
+export var resolveApiUrl = function (amplify, apiName, path, queryParams) {
+    var _a, _b, _c, _d;
+    var urlStr = (_d = (_c = (_b = (_a = amplify.getConfig()) === null || _a === void 0 ? void 0 : _a.API) === null || _b === void 0 ? void 0 : _b.REST) === null || _c === void 0 ? void 0 : _c[apiName]) === null || _d === void 0 ? void 0 : _d.endpoint;
+    assertValidationError(!!urlStr, RestApiValidationErrorCode.InvalidApiName);
+    try {
+        var url = new URL(urlStr + path);
+        if (queryParams) {
+            var mergedQueryParams_1 = new URLSearchParams(url.searchParams);
+            Object.entries(queryParams).forEach(function (_a) {
+                var _b = __read(_a, 2), key = _b[0], value = _b[1];
+                mergedQueryParams_1.set(key, value);
+            });
+            url.search = new URLSearchParams(mergedQueryParams_1).toString();
+        }
+        return url;
+    }
+    catch (error) {
+        throw new RestApiError(__assign(__assign({ name: RestApiValidationErrorCode.InvalidApiName }, validationErrorMap[RestApiValidationErrorCode.InvalidApiName]), { recoverySuggestion: "Please make sure the REST endpoint URL is a valid URL string. Got ".concat(urlStr) }));
+    }
+};

package/lib-esm/utils/resolveCredentials.d.ts

@@ -5,6 +5,6 @@ import { AmplifyClassV6 } from '@aws-amplify/core';
 export declare const resolveCredentials: (amplify: AmplifyClassV6) => Promise<{
     accessKeyId: string;
     secretAccessKey: string;
-    sessionToken?: string;
-    expiration?: Date;
+    sessionToken?: string | undefined;
+    expiration?: Date | undefined;
 }>;

package/lib-esm/utils/resolveCredentials.js

@@ -12,7 +12,7 @@ export var resolveCredentials = function (amplify) { return __awaiter(void 0, vo
             case 0: return [4 /*yield*/, amplify.Auth.fetchAuthSession()];
             case 1:
                 credentials = (_a.sent()).credentials;
-                assertValidationError(!!credentials, RestApiValidationErrorCode.NoCredentials);
+                assertValidationError(!!credentials && !!credentials.accessKeyId && !!credentials.secretAccessKey, RestApiValidationErrorCode.NoCredentials);
                 return [2 /*return*/, credentials];
         }
     });

package/lib-esm/utils/serviceError.d.ts

@@ -7,4 +7,4 @@ import { RestApiError } from '../errors';
  * @internal
  */
 export declare const buildRestApiServiceError: (error: Error) => RestApiError;
-export declare const parseRestApiServiceError: (response?: HttpResponse) => Promise<RestApiError & MetadataBearer>;
+export declare const parseRestApiServiceError: (response?: HttpResponse) => Promise<(RestApiError & MetadataBearer) | undefined>;

package/lib-esm/utils/serviceError.js

@@ -8,7 +8,7 @@ import { RestApiError } from '../errors';
  */
 export var buildRestApiServiceError = function (error) {
     var restApiError = new RestApiError({
-        name: error.name,
+        name: error === null || error === void 0 ? void 0 : error.name,
         message: error.message,
         underlyingError: error,
     });
@@ -21,11 +21,13 @@ export var parseRestApiServiceError = function (response) { return __awaiter(voi
             case 0: return [4 /*yield*/, parseJsonError(response)];
             case 1:
                 parsedError = _a.sent();
-                return [2 /*return*/, parsedError
-                        ? Object.assign(buildRestApiServiceError(parsedError), {
-                            $metadata: parsedError.$metadata,
-                        })
-                        : undefined];
+                if (!parsedError) {
+                    // Response is not an error.
+                    return [2 /*return*/];
+                }
+                return [2 /*return*/, Object.assign(buildRestApiServiceError(parsedError), {
+                        $metadata: parsedError.$metadata,
+                    })];
         }
     });
 }); };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@aws-amplify/api-rest",
   "private": false,
-  "version": "4.0.1-console-preview.b5a42af.0+b5a42af",
+  "version": "4.0.1-console-preview.9607e4a.0+9607e4a",
   "description": "Api-rest category of aws-amplify",
   "main": "./lib/index.js",
   "module": "./lib-esm/index.js",
@@ -47,15 +47,14 @@
     "src"
   ],
   "dependencies": {
-    "axios": "0.26.0",
-    "tslib": "^2.5.0",
-    "url": "0.11.0"
+    "tslib": "^2.5.0"
   },
   "peerDependencies": {
-    "@aws-amplify/core": "6.0.1-console-preview.b5a42af.0+b5a42af"
+    "@aws-amplify/core": "6.0.1-console-preview.9607e4a.0+9607e4a"
   },
   "devDependencies": {
-    "@aws-amplify/core": "6.0.1-console-preview.b5a42af.0+b5a42af",
+    "@aws-amplify/core": "6.0.1-console-preview.9607e4a.0+9607e4a",
+    "@aws-amplify/react-native": "1.0.1-console-preview.9607e4a.0+9607e4a",
     "typescript": "5.0.2"
   },
   "size-limit": [
@@ -110,5 +109,5 @@
       "<rootDir>/setupTests.ts"
     ]
   },
-  "gitHead": "b5a42af519fb741bb8056a814addd8804c8f60ec"
+  "gitHead": "9607e4a6e188ebac2e8992f289a64fc417132e05"
 }

package/src/{common → apis/common}/handler.ts

@@ -12,12 +12,12 @@ import {
 import { DocumentType } from '@aws-amplify/core/internals/utils';
 
 import {
-	createCancellableOperation,
 	parseRestApiServiceError,
-	parseUrl,
+	parseSigningInfo,
 	resolveCredentials,
-} from '../utils';
-import { normalizeHeaders } from '../utils/normalizeHeaders';
+} from '../../utils';
+import { normalizeHeaders } from '../../utils/normalizeHeaders';
+import { RestApiResponse } from '../../types';
 
 type HandlerOptions = Omit<HttpRequest, 'body' | 'headers'> & {
 	body?: DocumentType | FormData;
@@ -35,9 +35,8 @@ type SigningServiceInfo = {
  * @param amplify Amplify instance to to resolve credentials and tokens. Should use different instance in client-side
  *   and SSR
  * @param options Options accepted from public API options when calling the handlers.
- * @param signingServiceInfo Internal-only options for graphql client to overwrite the IAM signing service and region.
- *   MUST ONLY be used by internal post method consumed by GraphQL when auth mode is IAM. Otherwise IAM auth may not be
- *   used.
+ * @param signingServiceInfo Internal-only options enable IAM auth as well as to to overwrite the IAM signing service
+ *   and region. If specified, and NONE of API Key header or Auth header is present, IAM auth will be used.
  *
  * @internal
  */
@@ -45,7 +44,7 @@ export const transferHandler = async (
 	amplify: AmplifyClassV6,
 	options: HandlerOptions & { abortSignal: AbortSignal },
 	signingServiceInfo?: SigningServiceInfo
-) => {
+): Promise<RestApiResponse> => {
 	const { url, method, headers, body, withCredentials, abortSignal } = options;
 	const resolvedBody = body
 		? body instanceof FormData
@@ -78,7 +77,7 @@ export const transferHandler = async (
 
 	const isIamAuthApplicable = iamAuthApplicable(request, signingServiceInfo);
 	if (isIamAuthApplicable) {
-		const signingInfoFromUrl = parseUrl(url);
+		const signingInfoFromUrl = parseSigningInfo(url);
 		const signingService =
 			signingServiceInfo?.service ?? signingInfoFromUrl.service;
 		const signingRegion =

package/src/{common → apis/common}/internalPost.ts

@@ -3,10 +3,21 @@
 
 import { AmplifyClassV6 } from '@aws-amplify/core';
 
-import { InternalPostInput, RestApiResponse } from '../types';
+import { InternalPostInput, RestApiResponse } from '../../types';
 import { transferHandler } from './handler';
-import { createCancellableOperation } from '../utils';
+import { createCancellableOperation } from '../../utils';
 
+/**
+ * This weak map provides functionality to cancel a request given the promise containing the `post` request.
+ *
+ * 1. For every GraphQL POST request, an abort controller is created and supplied to the request.
+ * 2. The promise fulfilled by GraphGL POST request is then mapped to that abort controller.
+ * 3. The promise is returned to the external caller.
+ * 4. The caller can either wait for the promise to fulfill or call `cancel(promise)` to cancel the request.
+ * 5. If `cancel(promise)` is called, then the corresponding abort controller is retrieved from the map below.
+ * 6. GraphQL POST request will be rejected with the error message provided during cancel.
+ * 7. Caller can check if the error is because of cancelling by calling `isCancelError(error)`.
+ */
 const cancelTokenMap = new WeakMap<Promise<any>, AbortController>();
 
 /**

package/src/apis/common/publicApis.ts

@@ -0,0 +1,99 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+import { AmplifyClassV6 } from '@aws-amplify/core';
+import {
+	GetInput,
+	GetOperation,
+	PostInput,
+	PostOperation,
+	PutInput,
+	PutOperation,
+	DeleteInput,
+	DeleteOperation,
+	HeadInput,
+	HeadOperation,
+	PatchInput,
+	PatchOperation,
+	ApiInput,
+	RestApiOptionsBase,
+} from '../../types';
+import {
+	resolveApiUrl,
+	createCancellableOperation,
+	logger,
+	parseSigningInfo,
+} from '../../utils';
+import { transferHandler } from './handler';
+
+const publicHandler = (
+	amplify: AmplifyClassV6,
+	options: ApiInput<RestApiOptionsBase>,
+	method: string
+) =>
+	createCancellableOperation(async abortSignal => {
+		const { apiName, options: apiOptions = {}, path: apiPath } = options;
+		const url = resolveApiUrl(
+			amplify,
+			apiName,
+			apiPath,
+			apiOptions?.queryParams
+		);
+		const libraryOptionsHeaders =
+			await amplify.libraryOptions?.API?.REST?.headers?.({
+				apiName,
+			});
+		const { headers: invocationHeaders = {} } = apiOptions;
+		const headers = {
+			// custom headers from invocation options should precede library options
+			...libraryOptionsHeaders,
+			...invocationHeaders,
+		};
+		const signingServiceInfo = parseSigningInfo(url, {
+			amplify,
+			apiName,
+		});
+		logger.debug(
+			method,
+			url,
+			headers,
+			`IAM signing options: ${JSON.stringify(signingServiceInfo)}`
+		);
+		return transferHandler(
+			amplify,
+			{
+				...apiOptions,
+				url,
+				method,
+				headers,
+				abortSignal,
+			},
+			signingServiceInfo
+		);
+	});
+
+export const get = (amplify: AmplifyClassV6, input: GetInput): GetOperation =>
+	publicHandler(amplify, input, 'GET');
+
+export const post = (
+	amplify: AmplifyClassV6,
+	input: PostInput
+): PostOperation => publicHandler(amplify, input, 'POST');
+
+export const put = (amplify: AmplifyClassV6, input: PutInput): PutOperation =>
+	publicHandler(amplify, input, 'PUT');
+
+export const del = (
+	amplify: AmplifyClassV6,
+	input: DeleteInput
+): DeleteOperation => publicHandler(amplify, input, 'DELETE');
+
+export const head = (
+	amplify: AmplifyClassV6,
+	input: HeadInput
+): HeadOperation => publicHandler(amplify, input, 'HEAD');
+
+export const patch = (
+	amplify: AmplifyClassV6,
+	input: PatchInput
+): PatchOperation => publicHandler(amplify, input, 'PATCH');

package/src/apis/index.ts

@@ -0,0 +1,60 @@
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+
+import { Amplify } from '@aws-amplify/core';
+import {
+	get as commonGet,
+	post as commonPost,
+	put as commonPut,
+	del as commonDel,
+	head as commonHead,
+	patch as commonPatch,
+} from './common/publicApis';
+import {
+	DeleteInput,
+	DeleteOperation,
+	GetInput,
+	GetOperation,
+	HeadInput,
+	HeadOperation,
+	PatchInput,
+	PatchOperation,
+	PostInput,
+	PostOperation,
+	PutInput,
+	PutOperation,
+} from '../types';
+
+/**
+ * GET HTTP request
+ */
+export const get = (input: GetInput): GetOperation => commonGet(Amplify, input);
+
+/**
+ * POST HTTP request
+ */
+export const post = (input: PostInput): PostOperation =>
+	commonPost(Amplify, input);
+
+/**
+ * PUT HTTP request
+ */
+export const put = (input: PutInput): PutOperation => commonPut(Amplify, input);
+
+/**
+ * DELETE HTTP request
+ */
+export const del = (input: DeleteInput): DeleteOperation =>
+	commonDel(Amplify, input);
+
+/**
+ * HEAD HTTP request
+ */
+export const head = (input: HeadInput): HeadOperation =>
+	commonHead(Amplify, input);
+
+/**
+ * PATCH HTTP request
+ */
+export const patch = (input: PatchInput): PatchOperation =>
+	commonPatch(Amplify, input);