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

package/dist/esm/internals/InternalGraphQLAPI.mjs

@@ -0,0 +1,270 @@
+import { parse, print } from 'graphql';
+import { catchError } from 'rxjs';
+import { AmplifyUrl, getAmplifyUserAgent } from '@aws-amplify/core/internals/utils';
+import { isCancelError } from '@aws-amplify/api-rest';
+import { updateRequestToBeCancellable, cancel, post } from '@aws-amplify/api-rest/internals';
+import { AWSAppSyncRealTimeProvider } from '../Providers/AWSAppSyncRealTimeProvider/index.mjs';
+import { resolveConfig } from '../utils/resolveConfig.mjs';
+import { resolveLibraryOptions } from '../utils/resolveLibraryOptions.mjs';
+import { repackageUnauthorizedError } from '../utils/errors/repackageAuthError.mjs';
+import { NO_ENDPOINT } from '../utils/errors/constants.mjs';
+import { GraphQLApiError } from '../utils/errors/GraphQLApiError.mjs';
+import '../utils/errors/validation.mjs';
+import { createGraphQLResultWithError } from '../utils/errors/createGraphQLResultWithError.mjs';
+import { isGraphQLResponseWithErrors } from './utils/runtimeTypeGuards/isGraphQLResponseWithErrors.mjs';
+import { headerBasedAuth } from './graphqlAuth.mjs';
+
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+const USER_AGENT_HEADER = 'x-amz-user-agent';
+const isAmplifyInstance = (amplify) => {
+    return typeof amplify !== 'function';
+};
+/**
+ * Export Cloud Logic APIs
+ */
+class InternalGraphQLAPIClass {
+    constructor() {
+        /**
+         * @private
+         */
+        this.appSyncRealTime = new Map();
+        this._api = {
+            post,
+            cancelREST: cancel,
+            isCancelErrorREST: isCancelError,
+            updateRequestToBeCancellable,
+        };
+    }
+    getModuleName() {
+        return 'InternalGraphQLAPI';
+    }
+    /**
+     * to get the operation type
+     * @param operation
+     */
+    getGraphqlOperationType(operation) {
+        const doc = parse(operation);
+        const definitions = doc.definitions;
+        const [{ operation: operationType }] = definitions;
+        return operationType;
+    }
+    /**
+     * Executes a GraphQL operation
+     *
+     * @param options - GraphQL Options
+     * @param [additionalHeaders] - headers to merge in after any `libraryConfigHeaders` set in the config
+     * @returns An Observable if the query is a subscription query, else a promise of the graphql result.
+     */
+    graphql(amplify, { query: paramQuery, variables = {}, authMode, authToken, endpoint, apiKey, }, additionalHeaders, customUserAgentDetails) {
+        const query = typeof paramQuery === 'string'
+            ? parse(paramQuery)
+            : parse(print(paramQuery));
+        const [operationDef = {}] = query.definitions.filter(def => def.kind === 'OperationDefinition');
+        const { operation: operationType } = operationDef;
+        const headers = additionalHeaders || {};
+        switch (operationType) {
+            case 'query':
+            case 'mutation': {
+                const abortController = new AbortController();
+                let responsePromise;
+                if (isAmplifyInstance(amplify)) {
+                    responsePromise = this._graphql(amplify, { query, variables, authMode, apiKey, endpoint }, headers, abortController, customUserAgentDetails, authToken);
+                }
+                else {
+                    // NOTE: this wrapper function must be await-able so the Amplify server context manager can
+                    // destroy the context only after it completes
+                    const wrapper = async (amplifyInstance) => {
+                        const result = await this._graphql(amplifyInstance, { query, variables, authMode, apiKey, endpoint }, headers, abortController, customUserAgentDetails, authToken);
+                        return result;
+                    };
+                    responsePromise = amplify(wrapper);
+                }
+                this._api.updateRequestToBeCancellable(responsePromise, abortController);
+                return responsePromise;
+            }
+            case 'subscription':
+                return this._graphqlSubscribe(amplify, { query, variables, authMode, apiKey, endpoint }, headers, customUserAgentDetails, authToken);
+            default:
+                throw new Error(`invalid operation type: ${operationType}`);
+        }
+    }
+    async _graphql(amplify, { query, variables, authMode: authModeOverride, endpoint: endpointOverride, apiKey: apiKeyOverride, }, additionalHeaders = {}, abortController, customUserAgentDetails, authToken) {
+        const { apiKey, region, endpoint: appSyncGraphqlEndpoint, customEndpoint, customEndpointRegion, defaultAuthMode, } = resolveConfig(amplify);
+        const initialAuthMode = authModeOverride || defaultAuthMode || 'iam';
+        // identityPool is an alias for iam. TODO: remove 'iam' in v7
+        const authMode = initialAuthMode === 'identityPool' ? 'iam' : initialAuthMode;
+        /**
+         * Retrieve library options from Amplify configuration.
+         * `customHeaders` here are from the Amplify configuration options,
+         * and are for non-AppSync endpoints only. These are *not* the same as
+         * `additionalHeaders`, which are custom headers that are either 1)
+         * included when configuring the API client or 2) passed along with
+         * individual requests.
+         */
+        const { headers: customHeaders, withCredentials } = resolveLibraryOptions(amplify);
+        /**
+         * Client or request-specific custom headers that may or may not be
+         * returned by a function:
+         */
+        let additionalCustomHeaders;
+        if (typeof additionalHeaders === 'function') {
+            const requestOptions = {
+                method: 'POST',
+                url: new AmplifyUrl(endpointOverride || customEndpoint || appSyncGraphqlEndpoint || '').toString(),
+                queryString: print(query),
+            };
+            additionalCustomHeaders = await additionalHeaders(requestOptions);
+        }
+        else {
+            additionalCustomHeaders = additionalHeaders;
+        }
+        // if an authorization header is set, have the explicit authToken take precedence
+        if (authToken) {
+            additionalCustomHeaders = {
+                ...additionalCustomHeaders,
+                Authorization: authToken,
+            };
+        }
+        const authHeaders = await headerBasedAuth(amplify, authMode, apiKeyOverride ?? apiKey, additionalCustomHeaders);
+        const headers = {
+            ...(!customEndpoint && authHeaders),
+            /**
+             * Custom endpoint headers.
+             * If there is both a custom endpoint and custom region present, we get the headers.
+             * If there is a custom endpoint but no region, we return an empty object.
+             * If neither are present, we return an empty object.
+             */
+            ...((customEndpoint && (customEndpointRegion ? authHeaders : {})) || {}),
+            // Custom headers included in Amplify configuration options:
+            ...(customHeaders &&
+                (await customHeaders({
+                    query: print(query),
+                    variables,
+                }))),
+            // Custom headers from individual requests or API client configuration:
+            ...additionalCustomHeaders,
+            // User agent headers:
+            ...(!customEndpoint && {
+                [USER_AGENT_HEADER]: getAmplifyUserAgent(customUserAgentDetails),
+            }),
+        };
+        const body = {
+            query: print(query),
+            variables: variables || null,
+        };
+        let signingServiceInfo;
+        /**
+         * We do not send the signing service info to the REST API under the
+         * following conditions (i.e. it will not sign the request):
+         *   - there is a custom endpoint but no region
+         *   - the auth mode is `none`, or `apiKey`
+         *   - the auth mode is a type other than the types listed below
+         */
+        if ((customEndpoint && !customEndpointRegion) ||
+            (authMode !== 'oidc' &&
+                authMode !== 'userPool' &&
+                authMode !== 'iam' &&
+                authMode !== 'lambda')) {
+            signingServiceInfo = undefined;
+        }
+        else {
+            signingServiceInfo = {
+                service: !customEndpointRegion ? 'appsync' : 'execute-api',
+                region: !customEndpointRegion ? region : customEndpointRegion,
+            };
+        }
+        const endpoint = endpointOverride || customEndpoint || appSyncGraphqlEndpoint;
+        if (!endpoint) {
+            throw createGraphQLResultWithError(new GraphQLApiError(NO_ENDPOINT));
+        }
+        let response;
+        try {
+            // 	// // See the inline doc of the REST `post()` API for possible errors to be thrown.
+            // 	// // As these errors are catastrophic they should be caught and handled by GraphQL
+            // 	// // API consumers.
+            const { body: responseBody } = await this._api.post(amplify, {
+                url: new AmplifyUrl(endpoint),
+                options: {
+                    headers,
+                    body,
+                    signingServiceInfo,
+                    withCredentials,
+                },
+                abortController,
+            });
+            response = await responseBody.json();
+        }
+        catch (error) {
+            if (this.isCancelError(error)) {
+                throw error;
+            }
+            response = createGraphQLResultWithError(error);
+        }
+        if (isGraphQLResponseWithErrors(response)) {
+            throw repackageUnauthorizedError(response);
+        }
+        return response;
+    }
+    /**
+     * Checks to see if an error thrown is from an api request cancellation
+     * @param {any} error - Any error
+     * @return {boolean} - A boolean indicating if the error was from an api request cancellation
+     */
+    isCancelError(error) {
+        return this._api.isCancelErrorREST(error);
+    }
+    /**
+     * Cancels an inflight request. Only applicable for graphql queries and mutations
+     * @param {any} request - request to cancel
+     * @returns - A boolean indicating if the request was cancelled
+     */
+    cancel(request, message) {
+        return this._api.cancelREST(request, message);
+    }
+    _graphqlSubscribe(amplify, { query, variables, authMode: authModeOverride, apiKey: apiKeyOverride, endpoint, }, additionalHeaders = {}, customUserAgentDetails, authToken) {
+        const config = resolveConfig(amplify);
+        const initialAuthMode = authModeOverride || config?.defaultAuthMode || 'iam';
+        // identityPool is an alias for iam. TODO: remove 'iam' in v7
+        const authMode = initialAuthMode === 'identityPool' ? 'iam' : initialAuthMode;
+        /**
+         * Retrieve library options from Amplify configuration.
+         * `libraryConfigHeaders` are from the Amplify configuration options,
+         * and will not be overwritten by other custom headers. These are *not*
+         * the same as `additionalHeaders`, which are custom headers that are
+         * either 1)included when configuring the API client or 2) passed along
+         * with individual requests.
+         */
+        const { headers: libraryConfigHeaders } = resolveLibraryOptions(amplify);
+        const appSyncGraphqlEndpoint = endpoint ?? config?.endpoint;
+        // TODO: This could probably be an exception. But, lots of tests rely on
+        // attempting to connect to nowhere. So, I'm treating as the opposite of
+        // a Chesterton's fence for now. (A fence I shouldn't build, because I don't
+        // know why somethings depends on its absence!)
+        const memoKey = appSyncGraphqlEndpoint ?? 'none';
+        const realtimeProvider = this.appSyncRealTime.get(memoKey) ?? new AWSAppSyncRealTimeProvider();
+        this.appSyncRealTime.set(memoKey, realtimeProvider);
+        return realtimeProvider
+            .subscribe({
+            query: print(query),
+            variables,
+            appSyncGraphqlEndpoint,
+            region: config?.region,
+            authenticationType: authMode,
+            apiKey: apiKeyOverride ?? config?.apiKey,
+            additionalHeaders,
+            authToken,
+            libraryConfigHeaders,
+        }, customUserAgentDetails)
+            .pipe(catchError(e => {
+            if (e.errors) {
+                throw repackageUnauthorizedError(e);
+            }
+            throw e;
+        }));
+    }
+}
+const InternalGraphQLAPI = new InternalGraphQLAPIClass();
+
+export { InternalGraphQLAPI, InternalGraphQLAPIClass };
+//# sourceMappingURL=InternalGraphQLAPI.mjs.map

package/dist/esm/internals/InternalGraphQLAPI.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"InternalGraphQLAPI.mjs","sources":["../../../src/internals/InternalGraphQLAPI.ts"],"sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\nimport { parse, print, } from 'graphql';\nimport { catchError } from 'rxjs';\nimport { AmplifyUrl, getAmplifyUserAgent, } from '@aws-amplify/core/internals/utils';\nimport { isCancelError as isCancelErrorREST } from '@aws-amplify/api-rest';\nimport { cancel as cancelREST, post, updateRequestToBeCancellable, } from '@aws-amplify/api-rest/internals';\nimport { AWSAppSyncRealTimeProvider } from '../Providers/AWSAppSyncRealTimeProvider';\nimport { resolveConfig, resolveLibraryOptions } from '../utils';\nimport { repackageUnauthorizedError } from '../utils/errors/repackageAuthError';\nimport { NO_ENDPOINT } from '../utils/errors/constants';\nimport { GraphQLApiError, createGraphQLResultWithError } from '../utils/errors';\nimport { isGraphQLResponseWithErrors } from './utils/runtimeTypeGuards/isGraphQLResponseWithErrors';\nimport { headerBasedAuth } from './graphqlAuth';\nconst USER_AGENT_HEADER = 'x-amz-user-agent';\nconst isAmplifyInstance = (amplify) => {\n    return typeof amplify !== 'function';\n};\n/**\n * Export Cloud Logic APIs\n */\nexport class InternalGraphQLAPIClass {\n    constructor() {\n        /**\n         * @private\n         */\n        this.appSyncRealTime = new Map();\n        this._api = {\n            post,\n            cancelREST,\n            isCancelErrorREST,\n            updateRequestToBeCancellable,\n        };\n    }\n    getModuleName() {\n        return 'InternalGraphQLAPI';\n    }\n    /**\n     * to get the operation type\n     * @param operation\n     */\n    getGraphqlOperationType(operation) {\n        const doc = parse(operation);\n        const definitions = doc.definitions;\n        const [{ operation: operationType }] = definitions;\n        return operationType;\n    }\n    /**\n     * Executes a GraphQL operation\n     *\n     * @param options - GraphQL Options\n     * @param [additionalHeaders] - headers to merge in after any `libraryConfigHeaders` set in the config\n     * @returns An Observable if the query is a subscription query, else a promise of the graphql result.\n     */\n    graphql(amplify, { query: paramQuery, variables = {}, authMode, authToken, endpoint, apiKey, }, additionalHeaders, customUserAgentDetails) {\n        const query = typeof paramQuery === 'string'\n            ? parse(paramQuery)\n            : parse(print(paramQuery));\n        const [operationDef = {}] = query.definitions.filter(def => def.kind === 'OperationDefinition');\n        const { operation: operationType } = operationDef;\n        const headers = additionalHeaders || {};\n        switch (operationType) {\n            case 'query':\n            case 'mutation': {\n                const abortController = new AbortController();\n                let responsePromise;\n                if (isAmplifyInstance(amplify)) {\n                    responsePromise = this._graphql(amplify, { query, variables, authMode, apiKey, endpoint }, headers, abortController, customUserAgentDetails, authToken);\n                }\n                else {\n                    // NOTE: this wrapper function must be await-able so the Amplify server context manager can\n                    // destroy the context only after it completes\n                    const wrapper = async (amplifyInstance) => {\n                        const result = await this._graphql(amplifyInstance, { query, variables, authMode, apiKey, endpoint }, headers, abortController, customUserAgentDetails, authToken);\n                        return result;\n                    };\n                    responsePromise = amplify(wrapper);\n                }\n                this._api.updateRequestToBeCancellable(responsePromise, abortController);\n                return responsePromise;\n            }\n            case 'subscription':\n                return this._graphqlSubscribe(amplify, { query, variables, authMode, apiKey, endpoint }, headers, customUserAgentDetails, authToken);\n            default:\n                throw new Error(`invalid operation type: ${operationType}`);\n        }\n    }\n    async _graphql(amplify, { query, variables, authMode: authModeOverride, endpoint: endpointOverride, apiKey: apiKeyOverride, }, additionalHeaders = {}, abortController, customUserAgentDetails, authToken) {\n        const { apiKey, region, endpoint: appSyncGraphqlEndpoint, customEndpoint, customEndpointRegion, defaultAuthMode, } = resolveConfig(amplify);\n        const initialAuthMode = authModeOverride || defaultAuthMode || 'iam';\n        // identityPool is an alias for iam. TODO: remove 'iam' in v7\n        const authMode = initialAuthMode === 'identityPool' ? 'iam' : initialAuthMode;\n        /**\n         * Retrieve library options from Amplify configuration.\n         * `customHeaders` here are from the Amplify configuration options,\n         * and are for non-AppSync endpoints only. These are *not* the same as\n         * `additionalHeaders`, which are custom headers that are either 1)\n         * included when configuring the API client or 2) passed along with\n         * individual requests.\n         */\n        const { headers: customHeaders, withCredentials } = resolveLibraryOptions(amplify);\n        /**\n         * Client or request-specific custom headers that may or may not be\n         * returned by a function:\n         */\n        let additionalCustomHeaders;\n        if (typeof additionalHeaders === 'function') {\n            const requestOptions = {\n                method: 'POST',\n                url: new AmplifyUrl(endpointOverride || customEndpoint || appSyncGraphqlEndpoint || '').toString(),\n                queryString: print(query),\n            };\n            additionalCustomHeaders = await additionalHeaders(requestOptions);\n        }\n        else {\n            additionalCustomHeaders = additionalHeaders;\n        }\n        // if an authorization header is set, have the explicit authToken take precedence\n        if (authToken) {\n            additionalCustomHeaders = {\n                ...additionalCustomHeaders,\n                Authorization: authToken,\n            };\n        }\n        const authHeaders = await headerBasedAuth(amplify, authMode, apiKeyOverride ?? apiKey, additionalCustomHeaders);\n        const headers = {\n            ...(!customEndpoint && authHeaders),\n            /**\n             * Custom endpoint headers.\n             * If there is both a custom endpoint and custom region present, we get the headers.\n             * If there is a custom endpoint but no region, we return an empty object.\n             * If neither are present, we return an empty object.\n             */\n            ...((customEndpoint && (customEndpointRegion ? authHeaders : {})) || {}),\n            // Custom headers included in Amplify configuration options:\n            ...(customHeaders &&\n                (await customHeaders({\n                    query: print(query),\n                    variables,\n                }))),\n            // Custom headers from individual requests or API client configuration:\n            ...additionalCustomHeaders,\n            // User agent headers:\n            ...(!customEndpoint && {\n                [USER_AGENT_HEADER]: getAmplifyUserAgent(customUserAgentDetails),\n            }),\n        };\n        const body = {\n            query: print(query),\n            variables: variables || null,\n        };\n        let signingServiceInfo;\n        /**\n         * We do not send the signing service info to the REST API under the\n         * following conditions (i.e. it will not sign the request):\n         *   - there is a custom endpoint but no region\n         *   - the auth mode is `none`, or `apiKey`\n         *   - the auth mode is a type other than the types listed below\n         */\n        if ((customEndpoint && !customEndpointRegion) ||\n            (authMode !== 'oidc' &&\n                authMode !== 'userPool' &&\n                authMode !== 'iam' &&\n                authMode !== 'lambda')) {\n            signingServiceInfo = undefined;\n        }\n        else {\n            signingServiceInfo = {\n                service: !customEndpointRegion ? 'appsync' : 'execute-api',\n                region: !customEndpointRegion ? region : customEndpointRegion,\n            };\n        }\n        const endpoint = endpointOverride || customEndpoint || appSyncGraphqlEndpoint;\n        if (!endpoint) {\n            throw createGraphQLResultWithError(new GraphQLApiError(NO_ENDPOINT));\n        }\n        let response;\n        try {\n            // \t// // See the inline doc of the REST `post()` API for possible errors to be thrown.\n            // \t// // As these errors are catastrophic they should be caught and handled by GraphQL\n            // \t// // API consumers.\n            const { body: responseBody } = await this._api.post(amplify, {\n                url: new AmplifyUrl(endpoint),\n                options: {\n                    headers,\n                    body,\n                    signingServiceInfo,\n                    withCredentials,\n                },\n                abortController,\n            });\n            response = await responseBody.json();\n        }\n        catch (error) {\n            if (this.isCancelError(error)) {\n                throw error;\n            }\n            response = createGraphQLResultWithError(error);\n        }\n        if (isGraphQLResponseWithErrors(response)) {\n            throw repackageUnauthorizedError(response);\n        }\n        return response;\n    }\n    /**\n     * Checks to see if an error thrown is from an api request cancellation\n     * @param {any} error - Any error\n     * @return {boolean} - A boolean indicating if the error was from an api request cancellation\n     */\n    isCancelError(error) {\n        return this._api.isCancelErrorREST(error);\n    }\n    /**\n     * Cancels an inflight request. Only applicable for graphql queries and mutations\n     * @param {any} request - request to cancel\n     * @returns - A boolean indicating if the request was cancelled\n     */\n    cancel(request, message) {\n        return this._api.cancelREST(request, message);\n    }\n    _graphqlSubscribe(amplify, { query, variables, authMode: authModeOverride, apiKey: apiKeyOverride, endpoint, }, additionalHeaders = {}, customUserAgentDetails, authToken) {\n        const config = resolveConfig(amplify);\n        const initialAuthMode = authModeOverride || config?.defaultAuthMode || 'iam';\n        // identityPool is an alias for iam. TODO: remove 'iam' in v7\n        const authMode = initialAuthMode === 'identityPool' ? 'iam' : initialAuthMode;\n        /**\n         * Retrieve library options from Amplify configuration.\n         * `libraryConfigHeaders` are from the Amplify configuration options,\n         * and will not be overwritten by other custom headers. These are *not*\n         * the same as `additionalHeaders`, which are custom headers that are\n         * either 1)included when configuring the API client or 2) passed along\n         * with individual requests.\n         */\n        const { headers: libraryConfigHeaders } = resolveLibraryOptions(amplify);\n        const appSyncGraphqlEndpoint = endpoint ?? config?.endpoint;\n        // TODO: This could probably be an exception. But, lots of tests rely on\n        // attempting to connect to nowhere. So, I'm treating as the opposite of\n        // a Chesterton's fence for now. (A fence I shouldn't build, because I don't\n        // know why somethings depends on its absence!)\n        const memoKey = appSyncGraphqlEndpoint ?? 'none';\n        const realtimeProvider = this.appSyncRealTime.get(memoKey) ?? new AWSAppSyncRealTimeProvider();\n        this.appSyncRealTime.set(memoKey, realtimeProvider);\n        return realtimeProvider\n            .subscribe({\n            query: print(query),\n            variables,\n            appSyncGraphqlEndpoint,\n            region: config?.region,\n            authenticationType: authMode,\n            apiKey: apiKeyOverride ?? config?.apiKey,\n            additionalHeaders,\n            authToken,\n            libraryConfigHeaders,\n        }, customUserAgentDetails)\n            .pipe(catchError(e => {\n            if (e.errors) {\n                throw repackageUnauthorizedError(e);\n            }\n            throw e;\n        }));\n    }\n}\nexport const InternalGraphQLAPI = new InternalGraphQLAPIClass();\n"],"names":["cancelREST","isCancelErrorREST"],"mappings":";;;;;;;;;;;;;;;;AAAA;AACA;AAaA,MAAM,iBAAiB,GAAG,kBAAkB;AAC5C,MAAM,iBAAiB,GAAG,CAAC,OAAO,KAAK;AACvC,IAAI,OAAO,OAAO,OAAO,KAAK,UAAU;AACxC,CAAC;AACD;AACA;AACA;AACO,MAAM,uBAAuB,CAAC;AACrC,IAAI,WAAW,GAAG;AAClB;AACA;AACA;AACA,QAAQ,IAAI,CAAC,eAAe,GAAG,IAAI,GAAG,EAAE;AACxC,QAAQ,IAAI,CAAC,IAAI,GAAG;AACpB,YAAY,IAAI;AAChB,wBAAYA,MAAU;AACtB,+BAAYC,aAAiB;AAC7B,YAAY,4BAA4B;AACxC,SAAS;AACT,IAAI;AACJ,IAAI,aAAa,GAAG;AACpB,QAAQ,OAAO,oBAAoB;AACnC,IAAI;AACJ;AACA;AACA;AACA;AACA,IAAI,uBAAuB,CAAC,SAAS,EAAE;AACvC,QAAQ,MAAM,GAAG,GAAG,KAAK,CAAC,SAAS,CAAC;AACpC,QAAQ,MAAM,WAAW,GAAG,GAAG,CAAC,WAAW;AAC3C,QAAQ,MAAM,CAAC,EAAE,SAAS,EAAE,aAAa,EAAE,CAAC,GAAG,WAAW;AAC1D,QAAQ,OAAO,aAAa;AAC5B,IAAI;AACJ;AACA;AACA;AACA;AACA;AACA;AACA;AACA,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,SAAS,GAAG,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,GAAG,EAAE,iBAAiB,EAAE,sBAAsB,EAAE;AAC/I,QAAQ,MAAM,KAAK,GAAG,OAAO,UAAU,KAAK;AAC5C,cAAc,KAAK,CAAC,UAAU;AAC9B,cAAc,KAAK,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;AACtC,QAAQ,MAAM,CAAC,YAAY,GAAG,EAAE,CAAC,GAAG,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,KAAK,qBAAqB,CAAC;AACvG,QAAQ,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,GAAG,YAAY;AACzD,QAAQ,MAAM,OAAO,GAAG,iBAAiB,IAAI,EAAE;AAC/C,QAAQ,QAAQ,aAAa;AAC7B,YAAY,KAAK,OAAO;AACxB,YAAY,KAAK,UAAU,EAAE;AAC7B,gBAAgB,MAAM,eAAe,GAAG,IAAI,eAAe,EAAE;AAC7D,gBAAgB,IAAI,eAAe;AACnC,gBAAgB,IAAI,iBAAiB,CAAC,OAAO,CAAC,EAAE;AAChD,oBAAoB,eAAe,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,SAAS,CAAC;AAC3K,gBAAgB;AAChB,qBAAqB;AACrB;AACA;AACA,oBAAoB,MAAM,OAAO,GAAG,OAAO,eAAe,KAAK;AAC/D,wBAAwB,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,eAAe,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,SAAS,CAAC;AAC1L,wBAAwB,OAAO,MAAM;AACrC,oBAAoB,CAAC;AACrB,oBAAoB,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC;AACtD,gBAAgB;AAChB,gBAAgB,IAAI,CAAC,IAAI,CAAC,4BAA4B,CAAC,eAAe,EAAE,eAAe,CAAC;AACxF,gBAAgB,OAAO,eAAe;AACtC,YAAY;AACZ,YAAY,KAAK,cAAc;AAC/B,gBAAgB,OAAO,IAAI,CAAC,iBAAiB,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,sBAAsB,EAAE,SAAS,CAAC;AACpJ,YAAY;AACZ,gBAAgB,MAAM,IAAI,KAAK,CAAC,CAAC,wBAAwB,EAAE,aAAa,CAAC,CAAC,CAAC;AAC3E;AACA,IAAI;AACJ,IAAI,MAAM,QAAQ,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,cAAc,GAAG,EAAE,iBAAiB,GAAG,EAAE,EAAE,eAAe,EAAE,sBAAsB,EAAE,SAAS,EAAE;AAC/M,QAAQ,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,sBAAsB,EAAE,cAAc,EAAE,oBAAoB,EAAE,eAAe,GAAG,GAAG,aAAa,CAAC,OAAO,CAAC;AACnJ,QAAQ,MAAM,eAAe,GAAG,gBAAgB,IAAI,eAAe,IAAI,KAAK;AAC5E;AACA,QAAQ,MAAM,QAAQ,GAAG,eAAe,KAAK,cAAc,GAAG,KAAK,GAAG,eAAe;AACrF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,QAAQ,MAAM,EAAE,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,GAAG,qBAAqB,CAAC,OAAO,CAAC;AAC1F;AACA;AACA;AACA;AACA,QAAQ,IAAI,uBAAuB;AACnC,QAAQ,IAAI,OAAO,iBAAiB,KAAK,UAAU,EAAE;AACrD,YAAY,MAAM,cAAc,GAAG;AACnC,gBAAgB,MAAM,EAAE,MAAM;AAC9B,gBAAgB,GAAG,EAAE,IAAI,UAAU,CAAC,gBAAgB,IAAI,cAAc,IAAI,sBAAsB,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE;AAClH,gBAAgB,WAAW,EAAE,KAAK,CAAC,KAAK,CAAC;AACzC,aAAa;AACb,YAAY,uBAAuB,GAAG,MAAM,iBAAiB,CAAC,cAAc,CAAC;AAC7E,QAAQ;AACR,aAAa;AACb,YAAY,uBAAuB,GAAG,iBAAiB;AACvD,QAAQ;AACR;AACA,QAAQ,IAAI,SAAS,EAAE;AACvB,YAAY,uBAAuB,GAAG;AACtC,gBAAgB,GAAG,uBAAuB;AAC1C,gBAAgB,aAAa,EAAE,SAAS;AACxC,aAAa;AACb,QAAQ;AACR,QAAQ,MAAM,WAAW,GAAG,MAAM,eAAe,CAAC,OAAO,EAAE,QAAQ,EAAE,cAAc,IAAI,MAAM,EAAE,uBAAuB,CAAC;AACvH,QAAQ,MAAM,OAAO,GAAG;AACxB,YAAY,IAAI,CAAC,cAAc,IAAI,WAAW,CAAC;AAC/C;AACA;AACA;AACA;AACA;AACA;AACA,YAAY,IAAI,CAAC,cAAc,KAAK,oBAAoB,GAAG,WAAW,GAAG,EAAE,CAAC,KAAK,EAAE,CAAC;AACpF;AACA,YAAY,IAAI,aAAa;AAC7B,iBAAiB,MAAM,aAAa,CAAC;AACrC,oBAAoB,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;AACvC,oBAAoB,SAAS;AAC7B,iBAAiB,CAAC,CAAC,CAAC;AACpB;AACA,YAAY,GAAG,uBAAuB;AACtC;AACA,YAAY,IAAI,CAAC,cAAc,IAAI;AACnC,gBAAgB,CAAC,iBAAiB,GAAG,mBAAmB,CAAC,sBAAsB,CAAC;AAChF,aAAa,CAAC;AACd,SAAS;AACT,QAAQ,MAAM,IAAI,GAAG;AACrB,YAAY,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;AAC/B,YAAY,SAAS,EAAE,SAAS,IAAI,IAAI;AACxC,SAAS;AACT,QAAQ,IAAI,kBAAkB;AAC9B;AACA;AACA;AACA;AACA;AACA;AACA;AACA,QAAQ,IAAI,CAAC,cAAc,IAAI,CAAC,oBAAoB;AACpD,aAAa,QAAQ,KAAK,MAAM;AAChC,gBAAgB,QAAQ,KAAK,UAAU;AACvC,gBAAgB,QAAQ,KAAK,KAAK;AAClC,gBAAgB,QAAQ,KAAK,QAAQ,CAAC,EAAE;AACxC,YAAY,kBAAkB,GAAG,SAAS;AAC1C,QAAQ;AACR,aAAa;AACb,YAAY,kBAAkB,GAAG;AACjC,gBAAgB,OAAO,EAAE,CAAC,oBAAoB,GAAG,SAAS,GAAG,aAAa;AAC1E,gBAAgB,MAAM,EAAE,CAAC,oBAAoB,GAAG,MAAM,GAAG,oBAAoB;AAC7E,aAAa;AACb,QAAQ;AACR,QAAQ,MAAM,QAAQ,GAAG,gBAAgB,IAAI,cAAc,IAAI,sBAAsB;AACrF,QAAQ,IAAI,CAAC,QAAQ,EAAE;AACvB,YAAY,MAAM,4BAA4B,CAAC,IAAI,eAAe,CAAC,WAAW,CAAC,CAAC;AAChF,QAAQ;AACR,QAAQ,IAAI,QAAQ;AACpB,QAAQ,IAAI;AACZ;AACA;AACA;AACA,YAAY,MAAM,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE;AACzE,gBAAgB,GAAG,EAAE,IAAI,UAAU,CAAC,QAAQ,CAAC;AAC7C,gBAAgB,OAAO,EAAE;AACzB,oBAAoB,OAAO;AAC3B,oBAAoB,IAAI;AACxB,oBAAoB,kBAAkB;AACtC,oBAAoB,eAAe;AACnC,iBAAiB;AACjB,gBAAgB,eAAe;AAC/B,aAAa,CAAC;AACd,YAAY,QAAQ,GAAG,MAAM,YAAY,CAAC,IAAI,EAAE;AAChD,QAAQ;AACR,QAAQ,OAAO,KAAK,EAAE;AACtB,YAAY,IAAI,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,EAAE;AAC3C,gBAAgB,MAAM,KAAK;AAC3B,YAAY;AACZ,YAAY,QAAQ,GAAG,4BAA4B,CAAC,KAAK,CAAC;AAC1D,QAAQ;AACR,QAAQ,IAAI,2BAA2B,CAAC,QAAQ,CAAC,EAAE;AACnD,YAAY,MAAM,0BAA0B,CAAC,QAAQ,CAAC;AACtD,QAAQ;AACR,QAAQ,OAAO,QAAQ;AACvB,IAAI;AACJ;AACA;AACA;AACA;AACA;AACA,IAAI,aAAa,CAAC,KAAK,EAAE;AACzB,QAAQ,OAAO,IAAI,CAAC,IAAI,CAAC,iBAAiB,CAAC,KAAK,CAAC;AACjD,IAAI;AACJ;AACA;AACA;AACA;AACA;AACA,IAAI,MAAM,CAAC,OAAO,EAAE,OAAO,EAAE;AAC7B,QAAQ,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC;AACrD,IAAI;AACJ,IAAI,iBAAiB,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,EAAE,cAAc,EAAE,QAAQ,GAAG,EAAE,iBAAiB,GAAG,EAAE,EAAE,sBAAsB,EAAE,SAAS,EAAE;AAC/K,QAAQ,MAAM,MAAM,GAAG,aAAa,CAAC,OAAO,CAAC;AAC7C,QAAQ,MAAM,eAAe,GAAG,gBAAgB,IAAI,MAAM,EAAE,eAAe,IAAI,KAAK;AACpF;AACA,QAAQ,MAAM,QAAQ,GAAG,eAAe,KAAK,cAAc,GAAG,KAAK,GAAG,eAAe;AACrF;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,QAAQ,MAAM,EAAE,OAAO,EAAE,oBAAoB,EAAE,GAAG,qBAAqB,CAAC,OAAO,CAAC;AAChF,QAAQ,MAAM,sBAAsB,GAAG,QAAQ,IAAI,MAAM,EAAE,QAAQ;AACnE;AACA;AACA;AACA;AACA,QAAQ,MAAM,OAAO,GAAG,sBAAsB,IAAI,MAAM;AACxD,QAAQ,MAAM,gBAAgB,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,IAAI,0BAA0B,EAAE;AACtG,QAAQ,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,OAAO,EAAE,gBAAgB,CAAC;AAC3D,QAAQ,OAAO;AACf,aAAa,SAAS,CAAC;AACvB,YAAY,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC;AAC/B,YAAY,SAAS;AACrB,YAAY,sBAAsB;AAClC,YAAY,MAAM,EAAE,MAAM,EAAE,MAAM;AAClC,YAAY,kBAAkB,EAAE,QAAQ;AACxC,YAAY,MAAM,EAAE,cAAc,IAAI,MAAM,EAAE,MAAM;AACpD,YAAY,iBAAiB;AAC7B,YAAY,SAAS;AACrB,YAAY,oBAAoB;AAChC,SAAS,EAAE,sBAAsB;AACjC,aAAa,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI;AAClC,YAAY,IAAI,CAAC,CAAC,MAAM,EAAE;AAC1B,gBAAgB,MAAM,0BAA0B,CAAC,CAAC,CAAC;AACnD,YAAY;AACZ,YAAY,MAAM,CAAC;AACnB,QAAQ,CAAC,CAAC,CAAC;AACX,IAAI;AACJ;AACY,MAAC,kBAAkB,GAAG,IAAI,uBAAuB;;;;"}

package/dist/esm/internals/events/appsyncRequest.d.ts

@@ -0,0 +1,14 @@
+import { AmplifyClassV6 } from '@aws-amplify/core';
+import { CustomUserAgentDetails, GraphQLAuthMode } from '@aws-amplify/core/internals/utils';
+import { CustomHeaders } from '@aws-amplify/data-schema/runtime';
+interface GqlRequestOptions {
+    apiKey?: string;
+    region?: string;
+    appSyncGraphqlEndpoint: string;
+    authenticationType: GraphQLAuthMode;
+    query: string;
+    variables: string[];
+    authToken?: string;
+}
+export declare function appsyncRequest<T = any>(amplify: AmplifyClassV6, options: GqlRequestOptions, additionalHeaders: CustomHeaders | undefined, abortController: AbortController, customUserAgentDetails?: CustomUserAgentDetails): Promise<T>;
+export {};

package/dist/esm/internals/events/appsyncRequest.mjs

@@ -0,0 +1,96 @@
+import { AmplifyUrl, getAmplifyUserAgent } from '@aws-amplify/core/internals/utils';
+import { post } from '@aws-amplify/api-rest/internals';
+import '../../utils/resolveConfig.mjs';
+import { resolveLibraryOptions } from '../../utils/resolveLibraryOptions.mjs';
+import { repackageUnauthorizedError } from '../../utils/errors/repackageAuthError.mjs';
+import { headerBasedAuth } from '../graphqlAuth.mjs';
+import { isGraphQLResponseWithErrors } from '../utils/runtimeTypeGuards/isGraphQLResponseWithErrors.mjs';
+
+const USER_AGENT_HEADER = 'x-amz-user-agent';
+// This is effectively a copy of InternalGraphQLAPI.ts._graphql(...)
+// Our existing unit tests are tightly coupled to the implementation, so i was unable to refactor
+// and extend _graphql() without having to change a bunch of tests as well... which in turn reduces confidence
+// that this feature will _not affect_ GQL behavior.
+async function appsyncRequest(amplify, options, additionalHeaders = {}, abortController, customUserAgentDetails) {
+    const { region, appSyncGraphqlEndpoint: endpoint, authenticationType: authMode, query, variables, } = options;
+    if (!endpoint) {
+        throw new Error('No endpoint');
+    }
+    const { withCredentials } = resolveLibraryOptions(amplify);
+    const headers = await requestHeaders(amplify, options, additionalHeaders, customUserAgentDetails);
+    const body = {
+        channel: query,
+        events: variables,
+    };
+    const signingServiceInfo = ['apiKey', 'none'].includes(authMode)
+        ? undefined
+        : {
+            service: 'appsync',
+            region,
+        };
+    const { body: responseBody } = await post(amplify, {
+        url: new AmplifyUrl(endpoint),
+        options: {
+            headers,
+            body,
+            signingServiceInfo,
+            withCredentials,
+        },
+        abortController,
+    });
+    const response = await responseBody.json();
+    if (isGraphQLResponseWithErrors(response)) {
+        throw repackageUnauthorizedError(response);
+    }
+    return response;
+}
+/**
+ * Computes all the necessary HTTP headers for the request based on:
+ * 1. Operation-level header options
+ * 2. Amplify.configure custom headers
+ * 3. AuthZ headers for explicit auth mode specified for operation ?? default auth mode in config
+ *
+ * @returns HTTP request headers key/value
+ */
+async function requestHeaders(amplify, options, additionalHeaders, customUserAgentDetails) {
+    const { apiKey, appSyncGraphqlEndpoint: endpoint, authenticationType: authMode, query, variables, authToken, } = options;
+    const { headers: customHeadersFn } = resolveLibraryOptions(amplify);
+    let additionalCustomHeaders;
+    if (typeof additionalHeaders === 'function') {
+        const requestOptions = {
+            method: 'POST',
+            url: new AmplifyUrl(endpoint).toString(),
+            queryString: query,
+        };
+        additionalCustomHeaders = await additionalHeaders(requestOptions);
+    }
+    else {
+        additionalCustomHeaders = additionalHeaders;
+    }
+    // if an authorization header is set, have the operation-level authToken take precedence
+    if (authToken) {
+        additionalCustomHeaders = {
+            ...additionalCustomHeaders,
+            Authorization: authToken,
+        };
+    }
+    const authHeaders = await headerBasedAuth(amplify, authMode, apiKey, additionalCustomHeaders);
+    const customHeaders = customHeadersFn &&
+        (await customHeadersFn({
+            query,
+            variables: variables,
+        }));
+    const headers = {
+        ...authHeaders,
+        // Custom headers included in Amplify configuration options:
+        ...customHeaders,
+        // Custom headers from individual requests or API client configuration:
+        ...additionalCustomHeaders,
+        // User agent headers:
+        [USER_AGENT_HEADER]: getAmplifyUserAgent(customUserAgentDetails),
+    };
+    return headers;
+}
+
+export { appsyncRequest };
+//# sourceMappingURL=appsyncRequest.mjs.map

package/dist/esm/internals/events/appsyncRequest.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"appsyncRequest.mjs","sources":["../../../../src/internals/events/appsyncRequest.ts"],"sourcesContent":["import { AmplifyUrl, getAmplifyUserAgent, } from '@aws-amplify/core/internals/utils';\nimport { post } from '@aws-amplify/api-rest/internals';\nimport { resolveLibraryOptions } from '../../utils';\nimport { repackageUnauthorizedError } from '../../utils/errors/repackageAuthError';\nimport { headerBasedAuth } from '../graphqlAuth';\nimport { isGraphQLResponseWithErrors } from '../utils/runtimeTypeGuards/isGraphQLResponseWithErrors';\nconst USER_AGENT_HEADER = 'x-amz-user-agent';\n// This is effectively a copy of InternalGraphQLAPI.ts._graphql(...)\n// Our existing unit tests are tightly coupled to the implementation, so i was unable to refactor\n// and extend _graphql() without having to change a bunch of tests as well... which in turn reduces confidence\n// that this feature will _not affect_ GQL behavior.\nexport async function appsyncRequest(amplify, options, additionalHeaders = {}, abortController, customUserAgentDetails) {\n    const { region, appSyncGraphqlEndpoint: endpoint, authenticationType: authMode, query, variables, } = options;\n    if (!endpoint) {\n        throw new Error('No endpoint');\n    }\n    const { withCredentials } = resolveLibraryOptions(amplify);\n    const headers = await requestHeaders(amplify, options, additionalHeaders, customUserAgentDetails);\n    const body = {\n        channel: query,\n        events: variables,\n    };\n    const signingServiceInfo = ['apiKey', 'none'].includes(authMode)\n        ? undefined\n        : {\n            service: 'appsync',\n            region,\n        };\n    const { body: responseBody } = await post(amplify, {\n        url: new AmplifyUrl(endpoint),\n        options: {\n            headers,\n            body,\n            signingServiceInfo,\n            withCredentials,\n        },\n        abortController,\n    });\n    const response = await responseBody.json();\n    if (isGraphQLResponseWithErrors(response)) {\n        throw repackageUnauthorizedError(response);\n    }\n    return response;\n}\n/**\n * Computes all the necessary HTTP headers for the request based on:\n * 1. Operation-level header options\n * 2. Amplify.configure custom headers\n * 3. AuthZ headers for explicit auth mode specified for operation ?? default auth mode in config\n *\n * @returns HTTP request headers key/value\n */\nasync function requestHeaders(amplify, options, additionalHeaders, customUserAgentDetails) {\n    const { apiKey, appSyncGraphqlEndpoint: endpoint, authenticationType: authMode, query, variables, authToken, } = options;\n    const { headers: customHeadersFn } = resolveLibraryOptions(amplify);\n    let additionalCustomHeaders;\n    if (typeof additionalHeaders === 'function') {\n        const requestOptions = {\n            method: 'POST',\n            url: new AmplifyUrl(endpoint).toString(),\n            queryString: query,\n        };\n        additionalCustomHeaders = await additionalHeaders(requestOptions);\n    }\n    else {\n        additionalCustomHeaders = additionalHeaders;\n    }\n    // if an authorization header is set, have the operation-level authToken take precedence\n    if (authToken) {\n        additionalCustomHeaders = {\n            ...additionalCustomHeaders,\n            Authorization: authToken,\n        };\n    }\n    const authHeaders = await headerBasedAuth(amplify, authMode, apiKey, additionalCustomHeaders);\n    const customHeaders = customHeadersFn &&\n        (await customHeadersFn({\n            query,\n            variables: variables,\n        }));\n    const headers = {\n        ...authHeaders,\n        // Custom headers included in Amplify configuration options:\n        ...customHeaders,\n        // Custom headers from individual requests or API client configuration:\n        ...additionalCustomHeaders,\n        // User agent headers:\n        [USER_AGENT_HEADER]: getAmplifyUserAgent(customUserAgentDetails),\n    };\n    return headers;\n}\n"],"names":[],"mappings":"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"}

package/dist/esm/internals/events/index.d.ts

@@ -0,0 +1,58 @@
+import { DocumentType } from '@aws-amplify/core/internals/utils';
+import type { EventsChannel, EventsOptions, PublishedEvent } from './types';
+/**
+ * @experimental API may change in future versions
+ *
+ * Establish a WebSocket connection to an Events channel
+ *
+ * @example
+ * const channel = await events.connect("default/channel")
+ *
+ * channel.subscribe({
+ *   next: (data) => { console.log(data) },
+ *   error: (err) => { console.error(err) },
+ * })
+ *
+ * @example // authMode override
+ * const channel = await events.connect("default/channel", { authMode: "userPool" })
+ *
+ * @param channel - channel path; `<namespace>/<channel>`
+ * @param options - request overrides: `authMode`, `authToken`
+ *
+ */
+declare function connect(channel: string, options?: EventsOptions): Promise<EventsChannel>;
+/**
+ * @experimental API may change in future versions
+ *
+ * Publish events to a channel via HTTP request
+ *
+ * @example
+ * await events.post("default/channel", { some: "event" })
+ *
+ * @example // event batching
+ * await events.post("default/channel", [{ some: "event" }, { some: "event2" }])
+ *
+ * @example // authMode override
+ * await events.post("default/channel", { some: "event" }, { authMode: "userPool" })
+ *
+ * @param channel - channel path; `<namespace>/<channel>`
+ * @param event - JSON-serializable value or an array of values
+ * @param options - request overrides: `authMode`, `authToken`
+ *
+ * @returns void on success
+ * @throws on error
+ */
+declare function post(channel: string, event: DocumentType | DocumentType[], options?: EventsOptions): Promise<void | PublishedEvent[]>;
+/**
+ * @experimental API may change in future versions
+ *
+ * Close WebSocket connection, disconnect listeners and reconnect observers
+ *
+ * @example
+ * await events.closeAll()
+ *
+ * @returns void on success
+ * @throws on error
+ */
+declare function closeAll(): Promise<void>;
+export { connect, post, closeAll };

package/dist/esm/internals/events/index.mjs

@@ -0,0 +1,139 @@
+import { Amplify } from '@aws-amplify/core';
+import { amplifyUuid } from '@aws-amplify/core/internals/utils';
+import { AppSyncEventProvider } from '../../Providers/AWSAppSyncEventsProvider/index.mjs';
+import { appsyncRequest } from './appsyncRequest.mjs';
+import { configure, normalizeAuth, serializeEvents } from './utils.mjs';
+
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+// Keeps a list of open channels in the websocket
+const openChannels = new Set();
+/**
+ * @experimental API may change in future versions
+ *
+ * Establish a WebSocket connection to an Events channel
+ *
+ * @example
+ * const channel = await events.connect("default/channel")
+ *
+ * channel.subscribe({
+ *   next: (data) => { console.log(data) },
+ *   error: (err) => { console.error(err) },
+ * })
+ *
+ * @example // authMode override
+ * const channel = await events.connect("default/channel", { authMode: "userPool" })
+ *
+ * @param channel - channel path; `<namespace>/<channel>`
+ * @param options - request overrides: `authMode`, `authToken`
+ *
+ */
+async function connect(channel, options) {
+    const providerOptions = configure();
+    providerOptions.authenticationType = normalizeAuth(options?.authMode, providerOptions.authenticationType);
+    providerOptions.apiKey = options?.apiKey || providerOptions.apiKey;
+    providerOptions.authToken = options?.authToken || providerOptions.authToken;
+    await AppSyncEventProvider.connect(providerOptions);
+    const channelId = amplifyUuid();
+    openChannels.add(channelId);
+    let _subscription;
+    const sub = (observer, subOptions) => {
+        if (!openChannels.has(channelId)) {
+            throw new Error('Channel is closed');
+        }
+        const subscribeOptions = { ...providerOptions, query: channel };
+        subscribeOptions.authenticationType = normalizeAuth(subOptions?.authMode, subscribeOptions.authenticationType);
+        subscribeOptions.apiKey = subOptions?.apiKey || subscribeOptions.apiKey;
+        subscribeOptions.authToken =
+            subOptions?.authToken || subscribeOptions.authToken;
+        _subscription = AppSyncEventProvider
+            .subscribe(subscribeOptions)
+            .subscribe(observer);
+        return _subscription;
+    };
+    const pub = async (event, pubOptions) => {
+        if (!openChannels.has(channelId)) {
+            throw new Error('Channel is closed');
+        }
+        const publishOptions = {
+            ...providerOptions,
+            query: channel,
+            variables: event,
+        };
+        publishOptions.authenticationType = normalizeAuth(pubOptions?.authMode, publishOptions.authenticationType);
+        publishOptions.apiKey = pubOptions?.apiKey || publishOptions.apiKey;
+        publishOptions.authToken =
+            pubOptions?.authToken || publishOptions.authToken;
+        return AppSyncEventProvider.publish(publishOptions);
+    };
+    const close = async () => {
+        _subscription && _subscription.unsubscribe();
+        openChannels.delete(channelId);
+        setTimeout(() => {
+            if (openChannels.size === 0) {
+                AppSyncEventProvider.closeIfNoActiveSubscription();
+            }
+        }, 1000);
+    };
+    return {
+        subscribe: sub,
+        close,
+        publish: pub,
+    };
+}
+/**
+ * @experimental API may change in future versions
+ *
+ * Publish events to a channel via HTTP request
+ *
+ * @example
+ * await events.post("default/channel", { some: "event" })
+ *
+ * @example // event batching
+ * await events.post("default/channel", [{ some: "event" }, { some: "event2" }])
+ *
+ * @example // authMode override
+ * await events.post("default/channel", { some: "event" }, { authMode: "userPool" })
+ *
+ * @param channel - channel path; `<namespace>/<channel>`
+ * @param event - JSON-serializable value or an array of values
+ * @param options - request overrides: `authMode`, `authToken`
+ *
+ * @returns void on success
+ * @throws on error
+ */
+async function post(channel, event, options) {
+    const providerOptions = configure();
+    providerOptions.authenticationType = normalizeAuth(options?.authMode, providerOptions.authenticationType);
+    providerOptions.apiKey = options?.apiKey || providerOptions.apiKey;
+    providerOptions.authToken = options?.authToken || providerOptions.authToken;
+    // trailing slash required in publish
+    const normalizedChannelName = channel[0] === '/' ? channel : `/${channel}`;
+    const publishOptions = {
+        ...providerOptions,
+        query: normalizedChannelName,
+        variables: serializeEvents(event),
+    };
+    const abortController = new AbortController();
+    const res = await appsyncRequest(Amplify, publishOptions, {}, abortController);
+    if (res.failed?.length > 0) {
+        return res.failed;
+    }
+}
+/**
+ * @experimental API may change in future versions
+ *
+ * Close WebSocket connection, disconnect listeners and reconnect observers
+ *
+ * @example
+ * await events.closeAll()
+ *
+ * @returns void on success
+ * @throws on error
+ */
+async function closeAll() {
+    await AppSyncEventProvider.close();
+}
+
+export { closeAll, connect, post };
+//# sourceMappingURL=index.mjs.map

package/dist/esm/internals/events/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sources":["../../../../src/internals/events/index.ts"],"sourcesContent":["// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.\n// SPDX-License-Identifier: Apache-2.0\nimport { Amplify } from '@aws-amplify/core';\nimport { amplifyUuid } from '@aws-amplify/core/internals/utils';\nimport { AppSyncEventProvider as eventProvider } from '../../Providers/AWSAppSyncEventsProvider';\nimport { appsyncRequest } from './appsyncRequest';\nimport { configure, normalizeAuth, serializeEvents } from './utils';\n// Keeps a list of open channels in the websocket\nconst openChannels = new Set();\n/**\n * @experimental API may change in future versions\n *\n * Establish a WebSocket connection to an Events channel\n *\n * @example\n * const channel = await events.connect(\"default/channel\")\n *\n * channel.subscribe({\n *   next: (data) => { console.log(data) },\n *   error: (err) => { console.error(err) },\n * })\n *\n * @example // authMode override\n * const channel = await events.connect(\"default/channel\", { authMode: \"userPool\" })\n *\n * @param channel - channel path; `<namespace>/<channel>`\n * @param options - request overrides: `authMode`, `authToken`\n *\n */\nasync function connect(channel, options) {\n    const providerOptions = configure();\n    providerOptions.authenticationType = normalizeAuth(options?.authMode, providerOptions.authenticationType);\n    providerOptions.apiKey = options?.apiKey || providerOptions.apiKey;\n    providerOptions.authToken = options?.authToken || providerOptions.authToken;\n    await eventProvider.connect(providerOptions);\n    const channelId = amplifyUuid();\n    openChannels.add(channelId);\n    let _subscription;\n    const sub = (observer, subOptions) => {\n        if (!openChannels.has(channelId)) {\n            throw new Error('Channel is closed');\n        }\n        const subscribeOptions = { ...providerOptions, query: channel };\n        subscribeOptions.authenticationType = normalizeAuth(subOptions?.authMode, subscribeOptions.authenticationType);\n        subscribeOptions.apiKey = subOptions?.apiKey || subscribeOptions.apiKey;\n        subscribeOptions.authToken =\n            subOptions?.authToken || subscribeOptions.authToken;\n        _subscription = eventProvider\n            .subscribe(subscribeOptions)\n            .subscribe(observer);\n        return _subscription;\n    };\n    const pub = async (event, pubOptions) => {\n        if (!openChannels.has(channelId)) {\n            throw new Error('Channel is closed');\n        }\n        const publishOptions = {\n            ...providerOptions,\n            query: channel,\n            variables: event,\n        };\n        publishOptions.authenticationType = normalizeAuth(pubOptions?.authMode, publishOptions.authenticationType);\n        publishOptions.apiKey = pubOptions?.apiKey || publishOptions.apiKey;\n        publishOptions.authToken =\n            pubOptions?.authToken || publishOptions.authToken;\n        return eventProvider.publish(publishOptions);\n    };\n    const close = async () => {\n        _subscription && _subscription.unsubscribe();\n        openChannels.delete(channelId);\n        setTimeout(() => {\n            if (openChannels.size === 0) {\n                eventProvider.closeIfNoActiveSubscription();\n            }\n        }, 1000);\n    };\n    return {\n        subscribe: sub,\n        close,\n        publish: pub,\n    };\n}\n/**\n * @experimental API may change in future versions\n *\n * Publish events to a channel via HTTP request\n *\n * @example\n * await events.post(\"default/channel\", { some: \"event\" })\n *\n * @example // event batching\n * await events.post(\"default/channel\", [{ some: \"event\" }, { some: \"event2\" }])\n *\n * @example // authMode override\n * await events.post(\"default/channel\", { some: \"event\" }, { authMode: \"userPool\" })\n *\n * @param channel - channel path; `<namespace>/<channel>`\n * @param event - JSON-serializable value or an array of values\n * @param options - request overrides: `authMode`, `authToken`\n *\n * @returns void on success\n * @throws on error\n */\nasync function post(channel, event, options) {\n    const providerOptions = configure();\n    providerOptions.authenticationType = normalizeAuth(options?.authMode, providerOptions.authenticationType);\n    providerOptions.apiKey = options?.apiKey || providerOptions.apiKey;\n    providerOptions.authToken = options?.authToken || providerOptions.authToken;\n    // trailing slash required in publish\n    const normalizedChannelName = channel[0] === '/' ? channel : `/${channel}`;\n    const publishOptions = {\n        ...providerOptions,\n        query: normalizedChannelName,\n        variables: serializeEvents(event),\n    };\n    const abortController = new AbortController();\n    const res = await appsyncRequest(Amplify, publishOptions, {}, abortController);\n    if (res.failed?.length > 0) {\n        return res.failed;\n    }\n}\n/**\n * @experimental API may change in future versions\n *\n * Close WebSocket connection, disconnect listeners and reconnect observers\n *\n * @example\n * await events.closeAll()\n *\n * @returns void on success\n * @throws on error\n */\nasync function closeAll() {\n    await eventProvider.close();\n}\nexport { connect, post, closeAll };\n"],"names":["eventProvider"],"mappings":"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"}