@aws-amplify/api-rest 0.0.0-unstable-1ca644b-20260128091132

package/dist/cjs/utils/isIamAuthApplicable.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.isIamAuthApplicableForRest = exports.isIamAuthApplicableForGraphQL = void 0;
+/**
+ * Determines if IAM authentication should be applied for a GraphQL request.
+ *
+ * This function checks the `headers` of the HTTP request to determine if IAM authentication
+ * is applicable. IAM authentication is considered applicable if there is no `authorization`
+ * header, no `x-api-key` header, and `signingServiceInfo` is provided.
+ *
+ * @param request - The HTTP request object containing headers.
+ * @param signingServiceInfo - Optional signing service information,
+ * including service and region.
+ * @returns A boolean `true` if IAM authentication should be applied.
+ *
+ * @internal
+ */
+const isIamAuthApplicableForGraphQL = ({ headers }, signingServiceInfo) => !headers.authorization && !headers['x-api-key'] && !!signingServiceInfo;
+exports.isIamAuthApplicableForGraphQL = isIamAuthApplicableForGraphQL;
+/**
+ * Determines if IAM authentication should be applied for a REST request.
+ *
+ * This function checks the `headers` of the HTTP request to determine if IAM authentication
+ * is applicable. IAM authentication is considered applicable if there is no `authorization`
+ * header and `signingServiceInfo` is provided.
+ *
+ * @param request - The HTTP request object containing headers.
+ * @param signingServiceInfo - Optional signing service information,
+ * including service and region.
+ * @returns A boolean `true` if IAM authentication should be applied.
+ *
+ * @internal
+ */
+const isIamAuthApplicableForRest = ({ headers }, signingServiceInfo) => !headers.authorization && !!signingServiceInfo;
+exports.isIamAuthApplicableForRest = isIamAuthApplicableForRest;
+//# sourceMappingURL=isIamAuthApplicable.js.map

package/dist/cjs/utils/isIamAuthApplicable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"isIamAuthApplicable.js","sources":["../../../src/utils/isIamAuthApplicable.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.isIamAuthApplicableForRest = exports.isIamAuthApplicableForGraphQL = void 0;\n/**\n * Determines if IAM authentication should be applied for a GraphQL request.\n *\n * This function checks the `headers` of the HTTP request to determine if IAM authentication\n * is applicable. IAM authentication is considered applicable if there is no `authorization`\n * header, no `x-api-key` header, and `signingServiceInfo` is provided.\n *\n * @param request - The HTTP request object containing headers.\n * @param signingServiceInfo - Optional signing service information,\n * including service and region.\n * @returns A boolean `true` if IAM authentication should be applied.\n *\n * @internal\n */\nconst isIamAuthApplicableForGraphQL = ({ headers }, signingServiceInfo) => !headers.authorization && !headers['x-api-key'] && !!signingServiceInfo;\nexports.isIamAuthApplicableForGraphQL = isIamAuthApplicableForGraphQL;\n/**\n * Determines if IAM authentication should be applied for a REST request.\n *\n * This function checks the `headers` of the HTTP request to determine if IAM authentication\n * is applicable. IAM authentication is considered applicable if there is no `authorization`\n * header and `signingServiceInfo` is provided.\n *\n * @param request - The HTTP request object containing headers.\n * @param signingServiceInfo - Optional signing service information,\n * including service and region.\n * @returns A boolean `true` if IAM authentication should be applied.\n *\n * @internal\n */\nconst isIamAuthApplicableForRest = ({ headers }, signingServiceInfo) => !headers.authorization && !!signingServiceInfo;\nexports.isIamAuthApplicableForRest = isIamAuthApplicableForRest;\n"],"names":[],"mappings":";;AACA;AACA;AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,0BAA0B,GAAG,OAAO,CAAC,6BAA6B,GAAG,MAAM;AACnF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,6BAA6B,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE,kBAAkB,KAAK,CAAC,OAAO,CAAC,aAAa,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,kBAAkB;AAClJ,OAAO,CAAC,6BAA6B,GAAG,6BAA6B;AACrE;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,0BAA0B,GAAG,CAAC,EAAE,OAAO,EAAE,EAAE,kBAAkB,KAAK,CAAC,OAAO,CAAC,aAAa,IAAI,CAAC,CAAC,kBAAkB;AACtH,OAAO,CAAC,0BAA0B,GAAG,0BAA0B;;"}

package/dist/cjs/utils/logger.js

@@ -0,0 +1,9 @@
+'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.logger = void 0;
+const core_1 = require("@aws-amplify/core");
+exports.logger = new core_1.ConsoleLogger('RestApis');
+//# sourceMappingURL=logger.js.map

package/dist/cjs/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sources":["../../../src/utils/logger.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.logger = void 0;\nconst core_1 = require(\"@aws-amplify/core\");\nexports.logger = new core_1.ConsoleLogger('RestApis');\n"],"names":[],"mappings":";;AACA;AACA;AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,MAAM,GAAG,MAAM;AACvB,MAAM,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;AAC3C,OAAO,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,aAAa,CAAC,UAAU,CAAC;;"}

package/dist/cjs/utils/parseSigningInfo.js

@@ -0,0 +1,43 @@
+'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.parseSigningInfo = void 0;
+const constants_1 = require("./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
+ */
+const parseSigningInfo = (url, restApiOptions) => {
+    const { service: signingService = constants_1.DEFAULT_REST_IAM_SIGNING_SERVICE, region: signingRegion = constants_1.DEFAULT_IAM_SIGNING_REGION, } = restApiOptions?.amplify.getConfig()?.API?.REST?.[restApiOptions?.apiName] ??
+        {};
+    const { hostname } = url;
+    const [, service, region] = constants_1.APIG_HOSTNAME_PATTERN.exec(hostname) ?? [];
+    if (service === constants_1.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,
+            region: 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 ?? signingRegion,
+        };
+    }
+    else {
+        return {
+            service: signingService,
+            region: signingRegion,
+        };
+    }
+};
+exports.parseSigningInfo = parseSigningInfo;
+//# sourceMappingURL=parseSigningInfo.js.map

package/dist/cjs/utils/parseSigningInfo.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseSigningInfo.js","sources":["../../../src/utils/parseSigningInfo.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.parseSigningInfo = void 0;\nconst constants_1 = require(\"./constants\");\n/**\n * Infer the signing service and region from the given URL, and for REST API only, from the Amplify configuration.\n * It supports raw API Gateway endpoint and AppSync endpoint.\n *\n * @internal\n */\nconst parseSigningInfo = (url, restApiOptions) => {\n    const { service: signingService = constants_1.DEFAULT_REST_IAM_SIGNING_SERVICE, region: signingRegion = constants_1.DEFAULT_IAM_SIGNING_REGION, } = restApiOptions?.amplify.getConfig()?.API?.REST?.[restApiOptions?.apiName] ??\n        {};\n    const { hostname } = url;\n    const [, service, region] = constants_1.APIG_HOSTNAME_PATTERN.exec(hostname) ?? [];\n    if (service === constants_1.DEFAULT_REST_IAM_SIGNING_SERVICE) {\n        // The configured endpoint is an API Gateway endpoint\n        // @see: https://docs.aws.amazon.com/apigateway/latest/developerguide/how-to-call-api.html\n        return {\n            service,\n            region: region ?? signingRegion,\n        };\n    }\n    else if (service === 'appsync-api') {\n        // AppSync endpoint is internally supported because GraphQL operation will send request using POST handler.\n        // example: https://xxxx.appsync-api.us-east-1.amazonaws.com/graphql\n        return {\n            service: 'appsync',\n            region: region ?? signingRegion,\n        };\n    }\n    else {\n        return {\n            service: signingService,\n            region: signingRegion,\n        };\n    }\n};\nexports.parseSigningInfo = parseSigningInfo;\n"],"names":[],"mappings":";;AACA;AACA;AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,gBAAgB,GAAG,MAAM;AACjC,MAAM,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC;AAC1C;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,gBAAgB,GAAG,CAAC,GAAG,EAAE,cAAc,KAAK;AAClD,IAAI,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,WAAW,CAAC,gCAAgC,EAAE,MAAM,EAAE,aAAa,GAAG,WAAW,CAAC,0BAA0B,GAAG,GAAG,cAAc,EAAE,OAAO,CAAC,SAAS,EAAE,EAAE,GAAG,EAAE,IAAI,GAAG,cAAc,EAAE,OAAO,CAAC;AACjO,QAAQ,EAAE;AACV,IAAI,MAAM,EAAE,QAAQ,EAAE,GAAG,GAAG;AAC5B,IAAI,MAAM,GAAG,OAAO,EAAE,MAAM,CAAC,GAAG,WAAW,CAAC,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE;AACtF,IAAI,IAAI,OAAO,KAAK,WAAW,CAAC,gCAAgC,EAAE;AAClE;AACA;AACA,QAAQ,OAAO;AACf,YAAY,OAAO;AACnB,YAAY,MAAM,EAAE,MAAM,IAAI,aAAa;AAC3C,SAAS;AACT,IAAI;AACJ,SAAS,IAAI,OAAO,KAAK,aAAa,EAAE;AACxC;AACA;AACA,QAAQ,OAAO;AACf,YAAY,OAAO,EAAE,SAAS;AAC9B,YAAY,MAAM,EAAE,MAAM,IAAI,aAAa;AAC3C,SAAS;AACT,IAAI;AACJ,SAAS;AACT,QAAQ,OAAO;AACf,YAAY,OAAO,EAAE,cAAc;AACnC,YAAY,MAAM,EAAE,aAAa;AACjC,SAAS;AACT,IAAI;AACJ,CAAC;AACD,OAAO,CAAC,gBAAgB,GAAG,gBAAgB;;"}

package/dist/cjs/utils/resolveApiUrl.js

@@ -0,0 +1,48 @@
+'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.resolveApiUrl = void 0;
+const utils_1 = require("@aws-amplify/core/internals/utils");
+const errors_1 = require("../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
+ */
+const resolveApiUrl = (amplify, apiName, path, queryParams) => {
+    const urlStr = amplify.getConfig()?.API?.REST?.[apiName]?.endpoint;
+    (0, errors_1.assertValidationError)(!!urlStr, errors_1.RestApiValidationErrorCode.InvalidApiName);
+    try {
+        let url;
+        if (utils_1.AmplifyUrl.canParse(urlStr + path)) {
+            url = new utils_1.AmplifyUrl(urlStr + path);
+        }
+        else {
+            url = new utils_1.AmplifyUrl(urlStr + path, location?.origin);
+        }
+        if (queryParams) {
+            const mergedQueryParams = new utils_1.AmplifyUrlSearchParams(url.searchParams);
+            Object.entries(queryParams).forEach(([key, value]) => {
+                mergedQueryParams.set(key, value);
+            });
+            url.search = new utils_1.AmplifyUrlSearchParams(mergedQueryParams).toString();
+        }
+        return url;
+    }
+    catch (error) {
+        throw new errors_1.RestApiError({
+            name: errors_1.RestApiValidationErrorCode.InvalidApiName,
+            ...errors_1.validationErrorMap[errors_1.RestApiValidationErrorCode.InvalidApiName],
+            recoverySuggestion: `Please make sure the REST endpoint URL is a valid URL string. Got ${urlStr}`,
+        });
+    }
+};
+exports.resolveApiUrl = resolveApiUrl;
+//# sourceMappingURL=resolveApiUrl.js.map

package/dist/cjs/utils/resolveApiUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveApiUrl.js","sources":["../../../src/utils/resolveApiUrl.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.resolveApiUrl = void 0;\nconst utils_1 = require(\"@aws-amplify/core/internals/utils\");\nconst errors_1 = require(\"../errors\");\n/**\n * Resolve the REST API request URL by:\n * 1. Loading the REST API endpoint from the Amplify configuration with corresponding API name.\n * 2. Appending the path to the endpoint.\n * 3. Merge the query parameters from path and the queryParameter argument which is taken from the public REST API\n *   options.\n * 4. Validating the resulting URL string.\n *\n * @internal\n */\nconst resolveApiUrl = (amplify, apiName, path, queryParams) => {\n    const urlStr = amplify.getConfig()?.API?.REST?.[apiName]?.endpoint;\n    (0, errors_1.assertValidationError)(!!urlStr, errors_1.RestApiValidationErrorCode.InvalidApiName);\n    try {\n        let url;\n        if (utils_1.AmplifyUrl.canParse(urlStr + path)) {\n            url = new utils_1.AmplifyUrl(urlStr + path);\n        }\n        else {\n            url = new utils_1.AmplifyUrl(urlStr + path, location?.origin);\n        }\n        if (queryParams) {\n            const mergedQueryParams = new utils_1.AmplifyUrlSearchParams(url.searchParams);\n            Object.entries(queryParams).forEach(([key, value]) => {\n                mergedQueryParams.set(key, value);\n            });\n            url.search = new utils_1.AmplifyUrlSearchParams(mergedQueryParams).toString();\n        }\n        return url;\n    }\n    catch (error) {\n        throw new errors_1.RestApiError({\n            name: errors_1.RestApiValidationErrorCode.InvalidApiName,\n            ...errors_1.validationErrorMap[errors_1.RestApiValidationErrorCode.InvalidApiName],\n            recoverySuggestion: `Please make sure the REST endpoint URL is a valid URL string. Got ${urlStr}`,\n        });\n    }\n};\nexports.resolveApiUrl = resolveApiUrl;\n"],"names":[],"mappings":";;AACA;AACA;AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,aAAa,GAAG,MAAM;AAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,mCAAmC,CAAC;AAC5D,MAAM,QAAQ,GAAG,OAAO,CAAC,WAAW,CAAC;AACrC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,aAAa,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,KAAK;AAC/D,IAAI,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,EAAE,EAAE,GAAG,EAAE,IAAI,GAAG,OAAO,CAAC,EAAE,QAAQ;AACtE,IAAI,IAAI,QAAQ,CAAC,qBAAqB,EAAE,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,0BAA0B,CAAC,cAAc,CAAC;AACrG,IAAI,IAAI;AACR,QAAQ,IAAI,GAAG;AACf,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE;AACxD,YAAY,GAAG,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,IAAI,CAAC;AACvD,QAAQ;AACR,aAAa;AACb,YAAY,GAAG,GAAG,IAAI,OAAO,CAAC,UAAU,CAAC,MAAM,GAAG,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC;AACzE,QAAQ;AACR,QAAQ,IAAI,WAAW,EAAE;AACzB,YAAY,MAAM,iBAAiB,GAAG,IAAI,OAAO,CAAC,sBAAsB,CAAC,GAAG,CAAC,YAAY,CAAC;AAC1F,YAAY,MAAM,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,EAAE,KAAK,CAAC,KAAK;AAClE,gBAAgB,iBAAiB,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC;AACjD,YAAY,CAAC,CAAC;AACd,YAAY,GAAG,CAAC,MAAM,GAAG,IAAI,OAAO,CAAC,sBAAsB,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE;AACzF,QAAQ;AACR,QAAQ,OAAO,GAAG;AAClB,IAAI;AACJ,IAAI,OAAO,KAAK,EAAE;AAClB,QAAQ,MAAM,IAAI,QAAQ,CAAC,YAAY,CAAC;AACxC,YAAY,IAAI,EAAE,QAAQ,CAAC,0BAA0B,CAAC,cAAc;AACpE,YAAY,GAAG,QAAQ,CAAC,kBAAkB,CAAC,QAAQ,CAAC,0BAA0B,CAAC,cAAc,CAAC;AAC9F,YAAY,kBAAkB,EAAE,CAAC,kEAAkE,EAAE,MAAM,CAAC,CAAC;AAC7G,SAAS,CAAC;AACV,IAAI;AACJ,CAAC;AACD,OAAO,CAAC,aAAa,GAAG,aAAa;;"}

package/dist/cjs/utils/resolveHeaders.js

@@ -0,0 +1,34 @@
+'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.resolveHeaders = void 0;
+const resolveHeaders = (headers, body) => {
+    const normalizedHeaders = {};
+    for (const key in headers) {
+        normalizedHeaders[key.toLowerCase()] = headers[key];
+    }
+    if (body) {
+        const contentType = normalizedHeaders['content-type'];
+        const isJsonCompatible = contentType &&
+            (contentType.startsWith('application/json') ||
+                (contentType.startsWith('application/') &&
+                    contentType.includes('+json')));
+        if (!isJsonCompatible) {
+            normalizedHeaders['content-type'] = 'application/json; charset=UTF-8';
+        }
+        if (body instanceof FormData) {
+            /**
+             * If body is a FormData we should not allow setting content-type.
+             * It's because runtime HTTP handlers(xhr, fetch, undici, node-fetch,
+             * etc.) will modify the content-type value when setting multipart
+             * boundary.
+             */
+            delete normalizedHeaders['content-type'];
+        }
+    }
+    return normalizedHeaders;
+};
+exports.resolveHeaders = resolveHeaders;
+//# sourceMappingURL=resolveHeaders.js.map

package/dist/cjs/utils/resolveHeaders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveHeaders.js","sources":["../../../src/utils/resolveHeaders.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.resolveHeaders = void 0;\nconst resolveHeaders = (headers, body) => {\n    const normalizedHeaders = {};\n    for (const key in headers) {\n        normalizedHeaders[key.toLowerCase()] = headers[key];\n    }\n    if (body) {\n        const contentType = normalizedHeaders['content-type'];\n        const isJsonCompatible = contentType &&\n            (contentType.startsWith('application/json') ||\n                (contentType.startsWith('application/') &&\n                    contentType.includes('+json')));\n        if (!isJsonCompatible) {\n            normalizedHeaders['content-type'] = 'application/json; charset=UTF-8';\n        }\n        if (body instanceof FormData) {\n            /**\n             * If body is a FormData we should not allow setting content-type.\n             * It's because runtime HTTP handlers(xhr, fetch, undici, node-fetch,\n             * etc.) will modify the content-type value when setting multipart\n             * boundary.\n             */\n            delete normalizedHeaders['content-type'];\n        }\n    }\n    return normalizedHeaders;\n};\nexports.resolveHeaders = resolveHeaders;\n"],"names":[],"mappings":";;AACA;AACA;AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,cAAc,GAAG,MAAM;AAC/B,MAAM,cAAc,GAAG,CAAC,OAAO,EAAE,IAAI,KAAK;AAC1C,IAAI,MAAM,iBAAiB,GAAG,EAAE;AAChC,IAAI,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE;AAC/B,QAAQ,iBAAiB,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,GAAG,OAAO,CAAC,GAAG,CAAC;AAC3D,IAAI;AACJ,IAAI,IAAI,IAAI,EAAE;AACd,QAAQ,MAAM,WAAW,GAAG,iBAAiB,CAAC,cAAc,CAAC;AAC7D,QAAQ,MAAM,gBAAgB,GAAG,WAAW;AAC5C,aAAa,WAAW,CAAC,UAAU,CAAC,kBAAkB,CAAC;AACvD,iBAAiB,WAAW,CAAC,UAAU,CAAC,cAAc,CAAC;AACvD,oBAAoB,WAAW,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;AACnD,QAAQ,IAAI,CAAC,gBAAgB,EAAE;AAC/B,YAAY,iBAAiB,CAAC,cAAc,CAAC,GAAG,iCAAiC;AACjF,QAAQ;AACR,QAAQ,IAAI,IAAI,YAAY,QAAQ,EAAE;AACtC;AACA;AACA;AACA;AACA;AACA;AACA,YAAY,OAAO,iBAAiB,CAAC,cAAc,CAAC;AACpD,QAAQ;AACR,IAAI;AACJ,IAAI,OAAO,iBAAiB;AAC5B,CAAC;AACD,OAAO,CAAC,cAAc,GAAG,cAAc;;"}

package/dist/cjs/utils/resolveLibraryOptions.js

@@ -0,0 +1,16 @@
+'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.resolveLibraryOptions = void 0;
+/**
+ * @internal
+ */
+const resolveLibraryOptions = (amplify) => {
+    const retryStrategy = amplify.libraryOptions?.API?.REST?.retryStrategy;
+    const defaultAuthMode = amplify.libraryOptions?.API?.REST?.defaultAuthMode;
+    return { retryStrategy, defaultAuthMode };
+};
+exports.resolveLibraryOptions = resolveLibraryOptions;
+//# sourceMappingURL=resolveLibraryOptions.js.map

package/dist/cjs/utils/resolveLibraryOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveLibraryOptions.js","sources":["../../../src/utils/resolveLibraryOptions.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.resolveLibraryOptions = void 0;\n/**\n * @internal\n */\nconst resolveLibraryOptions = (amplify) => {\n    const retryStrategy = amplify.libraryOptions?.API?.REST?.retryStrategy;\n    const defaultAuthMode = amplify.libraryOptions?.API?.REST?.defaultAuthMode;\n    return { retryStrategy, defaultAuthMode };\n};\nexports.resolveLibraryOptions = resolveLibraryOptions;\n"],"names":[],"mappings":";;AACA;AACA;AACA,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;AAC7D,OAAO,CAAC,qBAAqB,GAAG,MAAM;AACtC;AACA;AACA;AACA,MAAM,qBAAqB,GAAG,CAAC,OAAO,KAAK;AAC3C,IAAI,MAAM,aAAa,GAAG,OAAO,CAAC,cAAc,EAAE,GAAG,EAAE,IAAI,EAAE,aAAa;AAC1E,IAAI,MAAM,eAAe,GAAG,OAAO,CAAC,cAAc,EAAE,GAAG,EAAE,IAAI,EAAE,eAAe;AAC9E,IAAI,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE;AAC7C,CAAC;AACD,OAAO,CAAC,qBAAqB,GAAG,qBAAqB;;"}

package/dist/cjs/utils/serviceError.js

@@ -0,0 +1,98 @@
+'use strict';
+
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseRestApiServiceError = void 0;
+const aws_client_utils_1 = require("@aws-amplify/core/internals/aws-client-utils");
+const errors_1 = require("../errors");
+/**
+ * Parses both AWS and non-AWS error responses coming from the users' backend code.
+ * * AWS errors generated by the AWS services(e.g. API Gateway, Bedrock). They can be Signature errors,
+ *   ClockSkew errors, etc. These responses will be parsed to errors with proper name and message from the AWS
+ *   services.
+ * * non-AWS errors thrown by the user code. They can contain any headers or body. Users need to access the
+ *   error.response to get the headers and body and parse them accordingly. The JS error name and message will
+ *   be `UnknownError` and `Unknown error` respectively.
+ */
+const parseRestApiServiceError = async (response) => {
+    if (!response) {
+        // Response is not considered an error.
+        return;
+    }
+    const parsedAwsError = await (0, aws_client_utils_1.parseJsonError)(stubErrorResponse(response));
+    if (!parsedAwsError) ;
+    else {
+        const bodyText = await response.body?.text();
+        return buildRestApiError(parsedAwsError, {
+            statusCode: response.statusCode,
+            headers: response.headers,
+            body: bodyText,
+        });
+    }
+};
+exports.parseRestApiServiceError = parseRestApiServiceError;
+/**
+ * The response object needs to be stub here because the parseAwsJsonError assumes the response body to be valid JSON.
+ * Although this is true for AWS services, it is not true for responses from user's code. Once the response body is
+ * unwrapped as JSON(and fail), it cannot be read as text again. Therefore, we need to stub the response body here to
+ * make sure we can read the error response body as a JSON, and may fall back to read as text if it is not a valid JSON.
+ */
+const stubErrorResponse = (response) => {
+    let bodyTextPromise;
+    const bodyProxy = new Proxy(response.body, {
+        get(target, prop, receiver) {
+            if (prop === 'json') {
+                // For potential AWS errors, error parser will try to parse the body as JSON first.
+                return async () => {
+                    if (!bodyTextPromise) {
+                        bodyTextPromise = target.text();
+                    }
+                    try {
+                        return JSON.parse(await bodyTextPromise);
+                    }
+                    catch (error) {
+                        // If response body is not a valid JSON, we stub it to be an empty object and eventually parsed
+                        // as an unknown error
+                        return {};
+                    }
+                };
+            }
+            else if (prop === 'text') {
+                // For non-AWS errors, users can access the body as a string as a fallback.
+                return async () => {
+                    if (!bodyTextPromise) {
+                        bodyTextPromise = target.text();
+                    }
+                    return bodyTextPromise;
+                };
+            }
+            else {
+                return Reflect.get(target, prop, receiver);
+            }
+        },
+    });
+    const responseProxy = new Proxy(response, {
+        get(target, prop, receiver) {
+            if (prop === 'body') {
+                return bodyProxy;
+            }
+            else {
+                return Reflect.get(target, prop, receiver);
+            }
+        },
+    });
+    return responseProxy;
+};
+/**
+ * Utility to create a new RestApiError from a service error.
+ */
+const buildRestApiError = (error, response) => {
+    const restApiError = new errors_1.RestApiError({
+        name: error?.name,
+        message: error.message,
+        underlyingError: error,
+        response,
+    });
+    // $metadata is only required for backwards compatibility.
+    return Object.assign(restApiError, { $metadata: error.$metadata });
+};
+//# sourceMappingURL=serviceError.js.map

package/dist/cjs/utils/serviceError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serviceError.js","sources":["../../../src/utils/serviceError.ts"],"sourcesContent":["\"use strict\";\nObject.defineProperty(exports, \"__esModule\", { value: true });\nexports.parseRestApiServiceError = void 0;\nconst aws_client_utils_1 = require(\"@aws-amplify/core/internals/aws-client-utils\");\nconst errors_1 = require(\"../errors\");\n/**\n * Parses both AWS and non-AWS error responses coming from the users' backend code.\n * * AWS errors generated by the AWS services(e.g. API Gateway, Bedrock). They can be Signature errors,\n *   ClockSkew errors, etc. These responses will be parsed to errors with proper name and message from the AWS\n *   services.\n * * non-AWS errors thrown by the user code. They can contain any headers or body. Users need to access the\n *   error.response to get the headers and body and parse them accordingly. The JS error name and message will\n *   be `UnknownError` and `Unknown error` respectively.\n */\nconst parseRestApiServiceError = async (response) => {\n    if (!response) {\n        // Response is not considered an error.\n        return;\n    }\n    const parsedAwsError = await (0, aws_client_utils_1.parseJsonError)(stubErrorResponse(response));\n    if (!parsedAwsError) {\n        // Response is not considered an error.\n    }\n    else {\n        const bodyText = await response.body?.text();\n        return buildRestApiError(parsedAwsError, {\n            statusCode: response.statusCode,\n            headers: response.headers,\n            body: bodyText,\n        });\n    }\n};\nexports.parseRestApiServiceError = parseRestApiServiceError;\n/**\n * The response object needs to be stub here because the parseAwsJsonError assumes the response body to be valid JSON.\n * Although this is true for AWS services, it is not true for responses from user's code. Once the response body is\n * unwrapped as JSON(and fail), it cannot be read as text again. Therefore, we need to stub the response body here to\n * make sure we can read the error response body as a JSON, and may fall back to read as text if it is not a valid JSON.\n */\nconst stubErrorResponse = (response) => {\n    let bodyTextPromise;\n    const bodyProxy = new Proxy(response.body, {\n        get(target, prop, receiver) {\n            if (prop === 'json') {\n                // For potential AWS errors, error parser will try to parse the body as JSON first.\n                return async () => {\n                    if (!bodyTextPromise) {\n                        bodyTextPromise = target.text();\n                    }\n                    try {\n                        return JSON.parse(await bodyTextPromise);\n                    }\n                    catch (error) {\n                        // If response body is not a valid JSON, we stub it to be an empty object and eventually parsed\n                        // as an unknown error\n                        return {};\n                    }\n                };\n            }\n            else if (prop === 'text') {\n                // For non-AWS errors, users can access the body as a string as a fallback.\n                return async () => {\n                    if (!bodyTextPromise) {\n                        bodyTextPromise = target.text();\n                    }\n                    return bodyTextPromise;\n                };\n            }\n            else {\n                return Reflect.get(target, prop, receiver);\n            }\n        },\n    });\n    const responseProxy = new Proxy(response, {\n        get(target, prop, receiver) {\n            if (prop === 'body') {\n                return bodyProxy;\n            }\n            else {\n                return Reflect.get(target, prop, receiver);\n            }\n        },\n    });\n    return responseProxy;\n};\n/**\n * Utility to create a new RestApiError from a service error.\n */\nconst buildRestApiError = (error, response) => {\n    const restApiError = new errors_1.RestApiError({\n        name: error?.name,\n        message: error.message,\n        underlyingError: error,\n        response,\n    });\n    // $metadata is only required for backwards compatibility.\n    return Object.assign(restApiError, { $metadata: error.$metadata });\n};\n"],"names":[],"mappings":"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"}

package/dist/esm/apis/common/baseHandlers/authenticatedHandler.d.ts

@@ -0,0 +1,5 @@
+import { HttpRequest, HttpResponse, RetryOptions, SigningOptions, UserAgentOptions } from '@aws-amplify/core/internals/aws-client-utils';
+/**
+ * @internal
+ */
+export declare const authenticatedHandler: (request: HttpRequest, options: UserAgentOptions & RetryOptions<HttpResponse> & SigningOptions & import("@aws-amplify/core/internals/aws-client-utils").HttpTransferOptions) => Promise<HttpResponse>;

package/dist/esm/apis/common/baseHandlers/authenticatedHandler.mjs

@@ -0,0 +1,16 @@
+import { fetchTransferHandler, userAgentMiddlewareFactory, retryMiddlewareFactory, signingMiddlewareFactory } from '@aws-amplify/core/internals/aws-client-utils';
+import { composeTransferHandler } from '@aws-amplify/core/internals/aws-client-utils/composers';
+
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * @internal
+ */
+const authenticatedHandler = composeTransferHandler(fetchTransferHandler, [
+    userAgentMiddlewareFactory,
+    retryMiddlewareFactory,
+    signingMiddlewareFactory,
+]);
+
+export { authenticatedHandler };
+//# sourceMappingURL=authenticatedHandler.mjs.map

package/dist/esm/apis/common/baseHandlers/authenticatedHandler.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"authenticatedHandler.mjs","sources":["../../../../../src/apis/common/baseHandlers/authenticatedHandler.ts"],"sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\nimport { fetchTransferHandler, retryMiddlewareFactory, signingMiddlewareFactory, userAgentMiddlewareFactory, } from '@aws-amplify/core/internals/aws-client-utils';\nimport { composeTransferHandler } from '@aws-amplify/core/internals/aws-client-utils/composers';\n/**\n * @internal\n */\nexport const authenticatedHandler = composeTransferHandler(fetchTransferHandler, [\n    userAgentMiddlewareFactory,\n    retryMiddlewareFactory,\n    signingMiddlewareFactory,\n]);\n"],"names":[],"mappings":";;;AAAA;AACA;AAGA;AACA;AACA;AACY,MAAC,oBAAoB,GAAG,sBAAsB,CAAC,oBAAoB,EAAE;AACjF,IAAI,0BAA0B;AAC9B,IAAI,sBAAsB;AAC1B,IAAI,wBAAwB;AAC5B,CAAC;;;;"}

package/dist/esm/apis/common/baseHandlers/unauthenticatedHandler.d.ts

@@ -0,0 +1,5 @@
+import { HttpRequest, HttpResponse, RetryOptions, UserAgentOptions } from '@aws-amplify/core/internals/aws-client-utils';
+/**
+ * @internal
+ */
+export declare const unauthenticatedHandler: (request: HttpRequest, options: UserAgentOptions & RetryOptions<HttpResponse> & import("@aws-amplify/core/internals/aws-client-utils").HttpTransferOptions) => Promise<HttpResponse>;

package/dist/esm/apis/common/baseHandlers/unauthenticatedHandler.mjs

@@ -0,0 +1,12 @@
+import { fetchTransferHandler, userAgentMiddlewareFactory, retryMiddlewareFactory } from '@aws-amplify/core/internals/aws-client-utils';
+import { composeTransferHandler } from '@aws-amplify/core/internals/aws-client-utils/composers';
+
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * @internal
+ */
+const unauthenticatedHandler = composeTransferHandler(fetchTransferHandler, [userAgentMiddlewareFactory, retryMiddlewareFactory]);
+
+export { unauthenticatedHandler };
+//# sourceMappingURL=unauthenticatedHandler.mjs.map

package/dist/esm/apis/common/baseHandlers/unauthenticatedHandler.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"unauthenticatedHandler.mjs","sources":["../../../../../src/apis/common/baseHandlers/unauthenticatedHandler.ts"],"sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\nimport { fetchTransferHandler, retryMiddlewareFactory, userAgentMiddlewareFactory, } from '@aws-amplify/core/internals/aws-client-utils';\nimport { composeTransferHandler } from '@aws-amplify/core/internals/aws-client-utils/composers';\n/**\n * @internal\n */\nexport const unauthenticatedHandler = composeTransferHandler(fetchTransferHandler, [userAgentMiddlewareFactory, retryMiddlewareFactory]);\n"],"names":[],"mappings":";;;AAAA;AACA;AAGA;AACA;AACA;AACY,MAAC,sBAAsB,GAAG,sBAAsB,CAAC,oBAAoB,EAAE,CAAC,0BAA0B,EAAE,sBAAsB,CAAC;;;;"}

package/dist/esm/apis/common/internalPost.d.ts

@@ -0,0 +1,43 @@
+import { AmplifyClassV6 } from '@aws-amplify/core';
+import { InternalPostInput, RestApiResponse } from '../../types';
+/**
+ * @internal
+ *
+ * REST POST handler to send GraphQL request to given endpoint. By default, it will use IAM to authorize
+ * the request. In some auth modes, the IAM auth has to be disabled. Here's how to set up the request auth correctly:
+ * * If auth mode is 'iam', you MUST NOT set 'authorization' header and 'x-api-key' header, since it would disable IAM
+ *   auth. You MUST also set 'input.options.signingServiceInfo' option.
+ *   * The including 'input.options.signingServiceInfo.service' and 'input.options.signingServiceInfo.region' are
+ *     optional. If omitted, the signing service and region will be inferred from url.
+ * * If auth mode is 'none', you MUST NOT set 'options.signingServiceInfo' option.
+ * * If auth mode is 'apiKey', you MUST set 'x-api-key' custom header.
+ * * If auth mode is 'oidc' or 'lambda' or 'userPool', you MUST set 'authorization' header.
+ *
+ * To make the internal post cancellable, you must also call `updateRequestToBeCancellable()` with the promise from
+ * internal post call and the abort controller supplied to the internal post call.
+ *
+ * @param amplify the AmplifyClassV6 instance - it may be the singleton used on Web, or an instance created within
+ * a context created by `runWithAmplifyServerContext`
+ * @param postInput an object of {@link InternalPostInput}
+ * @param postInput.url The URL that the POST request sends to
+ * @param postInput.options Options of the POST request
+ * @param postInput.abortController The abort controller used to cancel the POST request
+ * @returns a {@link RestApiResponse}
+ *
+ * @throws an {@link AmplifyError} with `Network Error` as the `message` when the external resource is unreachable due to one
+ * of the following reasons:
+ *   1. no network connection
+ *   2. CORS error
+ * @throws a {@link CanceledError} when the ongoing POST request get cancelled
+ */
+export declare const post: (amplify: AmplifyClassV6, { url, options, abortController }: InternalPostInput) => Promise<RestApiResponse>;
+/**
+ * Cancels a request given the promise returned by `post`.
+ * If the request is already completed, this function does nothing.
+ * It MUST be used after `updateRequestToBeCancellable` is called.
+ */
+export declare const cancel: (promise: Promise<RestApiResponse>, message?: string) => boolean;
+/**
+ * MUST be used to make a promise including internal `post` API call cancellable.
+ */
+export declare const updateRequestToBeCancellable: (promise: Promise<any>, controller: AbortController) => void;

package/dist/esm/apis/common/internalPost.mjs

@@ -0,0 +1,98 @@
+import { createCancellableOperation } from '../../utils/createCancellableOperation.mjs';
+import '@aws-amplify/core/internals/aws-client-utils';
+import '@aws-amplify/core/internals/utils';
+import '../../errors/validation.mjs';
+import '../../utils/logger.mjs';
+import { isIamAuthApplicableForGraphQL } from '../../utils/isIamAuthApplicable.mjs';
+import { transferHandler } from './transferHandler.mjs';
+
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+/**
+ * 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();
+/**
+ * @internal
+ *
+ * REST POST handler to send GraphQL request to given endpoint. By default, it will use IAM to authorize
+ * the request. In some auth modes, the IAM auth has to be disabled. Here's how to set up the request auth correctly:
+ * * If auth mode is 'iam', you MUST NOT set 'authorization' header and 'x-api-key' header, since it would disable IAM
+ *   auth. You MUST also set 'input.options.signingServiceInfo' option.
+ *   * The including 'input.options.signingServiceInfo.service' and 'input.options.signingServiceInfo.region' are
+ *     optional. If omitted, the signing service and region will be inferred from url.
+ * * If auth mode is 'none', you MUST NOT set 'options.signingServiceInfo' option.
+ * * If auth mode is 'apiKey', you MUST set 'x-api-key' custom header.
+ * * If auth mode is 'oidc' or 'lambda' or 'userPool', you MUST set 'authorization' header.
+ *
+ * To make the internal post cancellable, you must also call `updateRequestToBeCancellable()` with the promise from
+ * internal post call and the abort controller supplied to the internal post call.
+ *
+ * @param amplify the AmplifyClassV6 instance - it may be the singleton used on Web, or an instance created within
+ * a context created by `runWithAmplifyServerContext`
+ * @param postInput an object of {@link InternalPostInput}
+ * @param postInput.url The URL that the POST request sends to
+ * @param postInput.options Options of the POST request
+ * @param postInput.abortController The abort controller used to cancel the POST request
+ * @returns a {@link RestApiResponse}
+ *
+ * @throws an {@link AmplifyError} with `Network Error` as the `message` when the external resource is unreachable due to one
+ * of the following reasons:
+ *   1. no network connection
+ *   2. CORS error
+ * @throws a {@link CanceledError} when the ongoing POST request get cancelled
+ */
+const post = (amplify, { url, options, abortController }) => {
+    const controller = abortController ?? new AbortController();
+    const responsePromise = createCancellableOperation(async () => {
+        const response = transferHandler(amplify, {
+            url,
+            method: 'POST',
+            ...options,
+            abortSignal: controller.signal,
+            retryStrategy: {
+                strategy: 'jittered-exponential-backoff',
+            },
+        }, isIamAuthApplicableForGraphQL, options?.signingServiceInfo);
+        return response;
+    }, controller, 'internal');
+    const responseWithCleanUp = responsePromise.finally(() => {
+        cancelTokenMap.delete(responseWithCleanUp);
+    });
+    return responseWithCleanUp;
+};
+/**
+ * Cancels a request given the promise returned by `post`.
+ * If the request is already completed, this function does nothing.
+ * It MUST be used after `updateRequestToBeCancellable` is called.
+ */
+const cancel = (promise, message) => {
+    const controller = cancelTokenMap.get(promise);
+    if (controller) {
+        controller.abort(message);
+        if (message && controller.signal.reason !== message) {
+            // In runtimes where `AbortSignal.reason` is not supported, we track the reason ourselves.
+            // @ts-expect-error reason is read-only property.
+            controller.signal.reason = message;
+        }
+        return true;
+    }
+    return false;
+};
+/**
+ * MUST be used to make a promise including internal `post` API call cancellable.
+ */
+const updateRequestToBeCancellable = (promise, controller) => {
+    cancelTokenMap.set(promise, controller);
+};
+
+export { cancel, post, updateRequestToBeCancellable };
+//# sourceMappingURL=internalPost.mjs.map

package/dist/esm/apis/common/internalPost.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"internalPost.mjs","sources":["../../../../src/apis/common/internalPost.ts"],"sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\nimport { createCancellableOperation } from '../../utils';\nimport { isIamAuthApplicableForGraphQL } from '../../utils/isIamAuthApplicable';\nimport { transferHandler } from './transferHandler';\n/**\n * This weak map provides functionality to cancel a request given the promise containing the `post` request.\n *\n * 1. For every GraphQL POST request, an abort controller is created and supplied to the request.\n * 2. The promise fulfilled by GraphGL POST request is then mapped to that abort controller.\n * 3. The promise is returned to the external caller.\n * 4. The caller can either wait for the promise to fulfill or call `cancel(promise)` to cancel the request.\n * 5. If `cancel(promise)` is called, then the corresponding abort controller is retrieved from the map below.\n * 6. GraphQL POST request will be rejected with the error message provided during cancel.\n * 7. Caller can check if the error is because of cancelling by calling `isCancelError(error)`.\n */\nconst cancelTokenMap = new WeakMap();\n/**\n * @internal\n *\n * REST POST handler to send GraphQL request to given endpoint. By default, it will use IAM to authorize\n * the request. In some auth modes, the IAM auth has to be disabled. Here's how to set up the request auth correctly:\n * * If auth mode is 'iam', you MUST NOT set 'authorization' header and 'x-api-key' header, since it would disable IAM\n *   auth. You MUST also set 'input.options.signingServiceInfo' option.\n *   * The including 'input.options.signingServiceInfo.service' and 'input.options.signingServiceInfo.region' are\n *     optional. If omitted, the signing service and region will be inferred from url.\n * * If auth mode is 'none', you MUST NOT set 'options.signingServiceInfo' option.\n * * If auth mode is 'apiKey', you MUST set 'x-api-key' custom header.\n * * If auth mode is 'oidc' or 'lambda' or 'userPool', you MUST set 'authorization' header.\n *\n * To make the internal post cancellable, you must also call `updateRequestToBeCancellable()` with the promise from\n * internal post call and the abort controller supplied to the internal post call.\n *\n * @param amplify the AmplifyClassV6 instance - it may be the singleton used on Web, or an instance created within\n * a context created by `runWithAmplifyServerContext`\n * @param postInput an object of {@link InternalPostInput}\n * @param postInput.url The URL that the POST request sends to\n * @param postInput.options Options of the POST request\n * @param postInput.abortController The abort controller used to cancel the POST request\n * @returns a {@link RestApiResponse}\n *\n * @throws an {@link AmplifyError} with `Network Error` as the `message` when the external resource is unreachable due to one\n * of the following reasons:\n *   1. no network connection\n *   2. CORS error\n * @throws a {@link CanceledError} when the ongoing POST request get cancelled\n */\nexport const post = (amplify, { url, options, abortController }) => {\n    const controller = abortController ?? new AbortController();\n    const responsePromise = createCancellableOperation(async () => {\n        const response = transferHandler(amplify, {\n            url,\n            method: 'POST',\n            ...options,\n            abortSignal: controller.signal,\n            retryStrategy: {\n                strategy: 'jittered-exponential-backoff',\n            },\n        }, isIamAuthApplicableForGraphQL, options?.signingServiceInfo);\n        return response;\n    }, controller, 'internal');\n    const responseWithCleanUp = responsePromise.finally(() => {\n        cancelTokenMap.delete(responseWithCleanUp);\n    });\n    return responseWithCleanUp;\n};\n/**\n * Cancels a request given the promise returned by `post`.\n * If the request is already completed, this function does nothing.\n * It MUST be used after `updateRequestToBeCancellable` is called.\n */\nexport const cancel = (promise, message) => {\n    const controller = cancelTokenMap.get(promise);\n    if (controller) {\n        controller.abort(message);\n        if (message && controller.signal.reason !== message) {\n            // In runtimes where `AbortSignal.reason` is not supported, we track the reason ourselves.\n            // @ts-expect-error reason is read-only property.\n            controller.signal.reason = message;\n        }\n        return true;\n    }\n    return false;\n};\n/**\n * MUST be used to make a promise including internal `post` API call cancellable.\n */\nexport const updateRequestToBeCancellable = (promise, controller) => {\n    cancelTokenMap.set(promise, controller);\n};\n"],"names":[],"mappings":";;;;;;;;AAAA;AACA;AAIA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,MAAM,cAAc,GAAG,IAAI,OAAO,EAAE;AACpC;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,IAAI,GAAG,CAAC,OAAO,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,eAAe,EAAE,KAAK;AACpE,IAAI,MAAM,UAAU,GAAG,eAAe,IAAI,IAAI,eAAe,EAAE;AAC/D,IAAI,MAAM,eAAe,GAAG,0BAA0B,CAAC,YAAY;AACnE,QAAQ,MAAM,QAAQ,GAAG,eAAe,CAAC,OAAO,EAAE;AAClD,YAAY,GAAG;AACf,YAAY,MAAM,EAAE,MAAM;AAC1B,YAAY,GAAG,OAAO;AACtB,YAAY,WAAW,EAAE,UAAU,CAAC,MAAM;AAC1C,YAAY,aAAa,EAAE;AAC3B,gBAAgB,QAAQ,EAAE,8BAA8B;AACxD,aAAa;AACb,SAAS,EAAE,6BAA6B,EAAE,OAAO,EAAE,kBAAkB,CAAC;AACtE,QAAQ,OAAO,QAAQ;AACvB,IAAI,CAAC,EAAE,UAAU,EAAE,UAAU,CAAC;AAC9B,IAAI,MAAM,mBAAmB,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM;AAC9D,QAAQ,cAAc,CAAC,MAAM,CAAC,mBAAmB,CAAC;AAClD,IAAI,CAAC,CAAC;AACN,IAAI,OAAO,mBAAmB;AAC9B;AACA;AACA;AACA;AACA;AACA;AACY,MAAC,MAAM,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK;AAC5C,IAAI,MAAM,UAAU,GAAG,cAAc,CAAC,GAAG,CAAC,OAAO,CAAC;AAClD,IAAI,IAAI,UAAU,EAAE;AACpB,QAAQ,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC;AACjC,QAAQ,IAAI,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,MAAM,KAAK,OAAO,EAAE;AAC7D;AACA;AACA,YAAY,UAAU,CAAC,MAAM,CAAC,MAAM,GAAG,OAAO;AAC9C,QAAQ;AACR,QAAQ,OAAO,IAAI;AACnB,IAAI;AACJ,IAAI,OAAO,KAAK;AAChB;AACA;AACA;AACA;AACY,MAAC,4BAA4B,GAAG,CAAC,OAAO,EAAE,UAAU,KAAK;AACrE,IAAI,cAAc,CAAC,GAAG,CAAC,OAAO,EAAE,UAAU,CAAC;AAC3C;;;;"}

package/dist/esm/apis/common/publicApis.d.ts

@@ -0,0 +1,8 @@
+import { AmplifyClassV6 } from '@aws-amplify/core';
+import { DeleteInput, DeleteOperation, GetInput, GetOperation, HeadInput, HeadOperation, PatchInput, PatchOperation, PostInput, PostOperation, PutInput, PutOperation } from '../../types';
+export declare const get: (amplify: AmplifyClassV6, input: GetInput) => GetOperation;
+export declare const post: (amplify: AmplifyClassV6, input: PostInput) => PostOperation;
+export declare const put: (amplify: AmplifyClassV6, input: PutInput) => PutOperation;
+export declare const del: (amplify: AmplifyClassV6, input: DeleteInput) => DeleteOperation;
+export declare const head: (amplify: AmplifyClassV6, input: HeadInput) => HeadOperation;
+export declare const patch: (amplify: AmplifyClassV6, input: PatchInput) => PatchOperation;