@aws-amplify/api-graphql 3.4.12-api-v6-models.b3abc9b.0 → 4.0.0

package/lib/utils/errors/validation.js

@@ -0,0 +1,25 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+var APIValidationErrorCode;
+(function (APIValidationErrorCode) {
+    APIValidationErrorCode["NoAuthSession"] = "NoAuthSession";
+    APIValidationErrorCode["NoRegion"] = "NoRegion";
+    APIValidationErrorCode["NoCustomEndpoint"] = "NoCustomEndpoint";
+})(APIValidationErrorCode = exports.APIValidationErrorCode || (exports.APIValidationErrorCode = {}));
+exports.validationErrorMap = {
+    [APIValidationErrorCode.NoAuthSession]: {
+        message: 'Auth session should not be empty.',
+    },
+    // TODO: re-enable when working in all test environments:
+    // [APIValidationErrorCode.NoEndpoint]: {
+    // 	message: 'Missing endpoint',
+    // },
+    [APIValidationErrorCode.NoRegion]: {
+        message: 'Missing region.',
+    },
+    [APIValidationErrorCode.NoCustomEndpoint]: {
+        message: 'Custom endpoint region is present without custom endpoint.',
+    },
+};

package/lib/utils/index.d.ts

@@ -0,0 +1,2 @@
+export { resolveConfig } from './resolveConfig';
+export { resolveLibraryOptions } from './resolveLibraryOptions';

package/lib/utils/index.js

@@ -0,0 +1,8 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+var resolveConfig_1 = require("./resolveConfig");
+exports.resolveConfig = resolveConfig_1.resolveConfig;
+var resolveLibraryOptions_1 = require("./resolveLibraryOptions");
+exports.resolveLibraryOptions = resolveLibraryOptions_1.resolveLibraryOptions;

package/lib/utils/resolveConfig.d.ts

@@ -0,0 +1,12 @@
+import { AmplifyClassV6 } from '@aws-amplify/core';
+/**
+ * @internal
+ */
+export declare const resolveConfig: (amplify: AmplifyClassV6) => {
+    apiKey: string | undefined;
+    customEndpoint: string | undefined;
+    customEndpointRegion: string | undefined;
+    defaultAuthMode: "apiKey" | "oidc" | "userPool" | "iam" | "lambda" | "none" | undefined;
+    endpoint: string | undefined;
+    region: string | undefined;
+};

package/lib/utils/resolveConfig.js

@@ -0,0 +1,22 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+const errors_1 = require("./errors");
+/**
+ * @internal
+ */
+exports.resolveConfig = (amplify) => {
+    const { apiKey, customEndpoint, customEndpointRegion, defaultAuthMode, endpoint, region, } = amplify.getConfig().API?.GraphQL ?? {};
+    // TODO: re-enable when working in all test environments:
+    // assertValidationError(!!endpoint, APIValidationErrorCode.NoEndpoint);
+    errors_1.assertValidationError(!(!customEndpoint && customEndpointRegion), errors_1.APIValidationErrorCode.NoCustomEndpoint);
+    return {
+        apiKey,
+        customEndpoint,
+        customEndpointRegion,
+        defaultAuthMode,
+        endpoint,
+        region,
+    };
+};

package/lib/utils/resolveLibraryOptions.d.ts

@@ -0,0 +1,11 @@
+import { AmplifyClassV6 } from '@aws-amplify/core';
+/**
+ * @internal
+ */
+export declare const resolveLibraryOptions: (amplify: AmplifyClassV6) => {
+    headers: ((options: {
+        query: string;
+        variables?: Record<string, import("@aws-amplify/core/lib-esm/libraryUtils").DocumentType> | undefined;
+    }) => Promise<Record<string, string>>) | undefined;
+    withCredentials: boolean | undefined;
+};

package/lib/utils/resolveLibraryOptions.js

@@ -0,0 +1,12 @@
+"use strict";
+// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
+// SPDX-License-Identifier: Apache-2.0
+Object.defineProperty(exports, "__esModule", { value: true });
+/**
+ * @internal
+ */
+exports.resolveLibraryOptions = (amplify) => {
+    const headers = amplify.libraryOptions?.API?.GraphQL?.headers;
+    const withCredentials = amplify.libraryOptions?.API?.GraphQL?.withCredentials;
+    return { headers, withCredentials };
+};

package/lib-esm/GraphQLAPI.d.ts

@@ -1,10 +1,11 @@
+import { AmplifyClassV6 } from '@aws-amplify/core';
 import { GraphQLOptions, GraphQLResult } from './types';
 import { InternalGraphQLAPIClass } from './internals';
-import Observable from 'zen-observable-ts';
-export declare const graphqlOperation: (query: any, variables?: {}, authToken?: string) => {
+import { Observable } from 'rxjs';
+export declare const graphqlOperation: (query: any, variables?: {}, authToken?: string | undefined) => {
     query: any;
     variables: {};
-    authToken: string;
+    authToken: string | undefined;
 };
 /**
  * Export Cloud Logic APIs
@@ -18,8 +19,20 @@ export declare class GraphQLAPIClass extends InternalGraphQLAPIClass {
      * @param [additionalHeaders] - headers to merge in after any `graphql_headers` set in the config
      * @returns An Observable if the query is a subscription query, else a promise of the graphql result.
      */
-    graphql<T = any>(options: GraphQLOptions, additionalHeaders?: {
+    graphql<T = any>(amplify: AmplifyClassV6 | (() => Promise<AmplifyClassV6>), options: GraphQLOptions, additionalHeaders?: {
         [key: string]: string;
     }): Observable<GraphQLResult<T>> | Promise<GraphQLResult<T>>;
+    /**
+     * Checks to see if an error thrown is from an api request cancellation
+     * @param error - Any error
+     * @returns A boolean indicating if the error was from an api request cancellation
+     */
+    isCancelError(error: any): boolean;
+    /**
+     * 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: Promise<any>, message?: string): boolean;
 }
 export declare const GraphQLAPI: GraphQLAPIClass;

package/lib-esm/GraphQLAPI.js

@@ -1,27 +1,17 @@
-import { __extends } from "tslib";
-// Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
-// SPDX-License-Identifier: Apache-2.0
-import { Amplify } from '@aws-amplify/core';
+import { Category, ApiAction } from '@aws-amplify/core/internals/utils';
 import { InternalGraphQLAPIClass } from './internals';
-export var graphqlOperation = function (query, variables, authToken) {
-    if (variables === void 0) { variables = {}; }
-    return ({
-        query: query,
-        variables: variables,
-        authToken: authToken,
-    });
-};
+export const graphqlOperation = (query, variables = {}, authToken) => ({
+    query,
+    variables,
+    authToken,
+});
 /**
  * Export Cloud Logic APIs
  */
-var GraphQLAPIClass = /** @class */ (function (_super) {
-    __extends(GraphQLAPIClass, _super);
-    function GraphQLAPIClass() {
-        return _super !== null && _super.apply(this, arguments) || this;
-    }
-    GraphQLAPIClass.prototype.getModuleName = function () {
+export class GraphQLAPIClass extends InternalGraphQLAPIClass {
+    getModuleName() {
         return 'GraphQLAPI';
-    };
+    }
     /**
      * Executes a GraphQL operation
      *
@@ -29,12 +19,27 @@ var GraphQLAPIClass = /** @class */ (function (_super) {
      * @param [additionalHeaders] - headers to merge in after any `graphql_headers` set in the config
      * @returns An Observable if the query is a subscription query, else a promise of the graphql result.
      */
-    GraphQLAPIClass.prototype.graphql = function (options, additionalHeaders) {
-        return _super.prototype.graphql.call(this, options, additionalHeaders);
-    };
-    return GraphQLAPIClass;
-}(InternalGraphQLAPIClass));
-export { GraphQLAPIClass };
-export var GraphQLAPI = new GraphQLAPIClass(null);
-Amplify.register(GraphQLAPI);
-//# sourceMappingURL=GraphQLAPI.js.map
+    graphql(amplify, options, additionalHeaders) {
+        return super.graphql(amplify, options, additionalHeaders, {
+            category: Category.API,
+            action: ApiAction.GraphQl,
+        });
+    }
+    /**
+     * Checks to see if an error thrown is from an api request cancellation
+     * @param error - Any error
+     * @returns A boolean indicating if the error was from an api request cancellation
+     */
+    isCancelError(error) {
+        return super.isCancelError(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 super.cancel(request, message);
+    }
+}
+export const GraphQLAPI = new GraphQLAPIClass(null);

package/lib-esm/Providers/AWSAppSyncRealTimeProvider/index.d.ts

@@ -0,0 +1,64 @@
+import { Observable } from 'rxjs';
+import { GraphQLAuthMode, CustomUserAgentDetails, DocumentType } from '@aws-amplify/core/internals/utils';
+import { PubSubContentObserver } from '../../types/PubSub';
+import { SUBSCRIPTION_STATUS } from '../constants';
+export declare type ObserverQuery = {
+    observer: PubSubContentObserver;
+    query: string;
+    variables: Record<string, DocumentType>;
+    subscriptionState: SUBSCRIPTION_STATUS;
+    subscriptionReadyCallback?: Function;
+    subscriptionFailedCallback?: Function;
+    startAckTimeoutId?: ReturnType<typeof setTimeout>;
+};
+export interface AWSAppSyncRealTimeProviderOptions {
+    appSyncGraphqlEndpoint?: string;
+    authenticationType?: GraphQLAuthMode;
+    query?: string;
+    variables?: Record<string, DocumentType>;
+    apiKey?: string;
+    region?: string;
+    graphql_headers?: () => {} | (() => Promise<{}>);
+    additionalHeaders?: {
+        [key: string]: string;
+    };
+}
+export declare class AWSAppSyncRealTimeProvider {
+    private awsRealTimeSocket?;
+    private socketStatus;
+    private keepAliveTimeoutId?;
+    private keepAliveTimeout;
+    private keepAliveAlertTimeoutId?;
+    private subscriptionObserverMap;
+    private promiseArray;
+    private connectionState;
+    private readonly connectionStateMonitor;
+    private readonly reconnectionMonitor;
+    private connectionStateMonitorSubscription;
+    constructor(options?: AWSAppSyncRealTimeProviderOptions);
+    /**
+     * Mark the socket closed and release all active listeners
+     */
+    close(): void;
+    getNewWebSocket(url: string, protocol: string): WebSocket;
+    getProviderName(): string;
+    private isCustomDomain;
+    subscribe(options?: AWSAppSyncRealTimeProviderOptions, customUserAgentDetails?: CustomUserAgentDetails): Observable<Record<string, unknown>>;
+    private _startSubscriptionWithAWSAppSyncRealTime;
+    private _logStartSubscriptionError;
+    private _waitForSubscriptionToBeConnected;
+    private _sendUnsubscriptionMessage;
+    private _removeSubscriptionObserver;
+    private _closeSocketIfRequired;
+    private _handleIncomingSubscriptionMessage;
+    private _errorDisconnect;
+    private _timeoutStartSubscriptionAck;
+    private _initializeWebSocketConnection;
+    private _initializeRetryableHandshake;
+    private _initializeHandshake;
+    private _awsRealTimeHeaderBasedAuth;
+    private _awsAuthTokenHeader;
+    private _awsRealTimeApiKeyHeader;
+    private _awsRealTimeIAMHeader;
+    private _customAuthHeader;
+}