@aws-amplify/api-graphql 3.4.3 → 3.4.4-graphql-api-functional-options.2

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

@@ -0,0 +1,48 @@
+import { GraphQLResult } from './index';
+declare type UnionKeys<T> = T extends T ? keyof T : never;
+declare type StrictUnionHelper<T, TAll> = T extends any ? T & Partial<Record<Exclude<UnionKeys<TAll>, keyof T>, undefined>> : never;
+export declare type StrictUnion<T> = StrictUnionHelper<T, T>;
+export declare type SimpleAuthMode = {
+    authMode?: 'AMAZON_COGNITO_USERPOOLS' | 'API_KEY' | 'AWS_IAM';
+};
+export declare type LambdaAuthMode = {
+    authMode: 'AWS_LAMBDA';
+    authToken: string;
+};
+export declare type AuthMode = StrictUnion<SimpleAuthMode | LambdaAuthMode>;
+export declare type GeneratedQuery<InputType, OutputType> = string & {
+    __generatedQueryInput: InputType;
+    __generatedQueryOutput: OutputType;
+};
+export declare type GraphqlQueryOverrides<IN extends {}, OUT extends {}> = {
+    variables: IN;
+    result: OUT;
+};
+export declare type GraphqlQueryParams<TYPED_GQL_STRING extends string, FALLBACK_TYPES> = AuthMode & {
+    variables: TYPED_GQL_STRING extends GeneratedQuery<infer IN, infer OUT> ? IN : FALLBACK_TYPES extends GraphqlQueryOverrides<infer IN, infer OUT> ? IN : any;
+};
+export declare type GraphqlQueryResult<T extends string, S> = T extends GeneratedQuery<infer IN, infer OUT> ? GraphQLResult<OUT> : S extends GraphqlQueryOverrides<infer IN, infer OUT> ? GraphQLResult<OUT> : any;
+/** GraphQL mutate */
+export declare type GeneratedMutation<InputType, OutputType> = string & {
+    __generatedMutationInput: InputType;
+    __generatedMutationOutput: OutputType;
+};
+export declare type GraphqlMutationParams<TYPED_GQL_STRING extends string, OVERRIDE_TYPE> = AuthMode & {
+    variables: TYPED_GQL_STRING extends GeneratedMutation<infer IN, infer OUT> ? IN : OVERRIDE_TYPE extends GraphqlQueryOverrides<infer OVERRIDE_IN, infer OUT> ? OVERRIDE_IN : any;
+};
+export declare type GraphqlMutationResult<TYPED_GQL_STRING extends string, FALLBACK_TYPES> = TYPED_GQL_STRING extends GeneratedMutation<infer IN, infer OUT> ? GraphQLResult<OUT> : FALLBACK_TYPES extends GraphqlQueryOverrides<infer IN, infer OUT> ? GraphQLResult<OUT> : any;
+/** GraphQL subscribe */
+export declare type GeneratedSubscription<InputType, OutputType> = string & {
+    __generatedSubscriptionInput: InputType;
+    __generatedSubscriptionOutput: OutputType;
+};
+export declare type GraphqlSubscriptionParams<TYPED_GQL_STRING extends string, FALLBACK_TYPES> = AuthMode & {
+    variables: TYPED_GQL_STRING extends GeneratedSubscription<infer IN, infer OUT> ? IN : FALLBACK_TYPES extends GraphqlQueryOverrides<infer IN, infer OUT> ? IN : any;
+};
+export declare type GraphqlSubscriptionResult<TYPED_GQL_STRING extends string, FALLBACK_TYPES> = {
+    provider: any;
+    value: {
+        data: TYPED_GQL_STRING extends GeneratedSubscription<infer IN, infer OUT> ? OUT : FALLBACK_TYPES extends GraphqlQueryOverrides<infer IN, infer OUT> ? OUT : any;
+    };
+};
+export {};

package/lib-esm/types/v6.js

@@ -0,0 +1 @@
+//# sourceMappingURL=v6.js.map

package/lib-esm/types/v6.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v6.js","sourceRoot":"","sources":["../../src/types/v6.ts"],"names":[],"mappings":""}

package/lib-esm/v6.d.ts

@@ -0,0 +1,22 @@
+import { Observable } from 'zen-observable-ts';
+import { GraphqlQueryParams, GraphqlQueryResult, GraphqlMutationParams, GraphqlMutationResult, GraphqlSubscriptionParams, GraphqlSubscriptionResult } from './types/v6';
+import { GraphQLOptions, GraphQLResult } from './types';
+/**
+ * The proposed interface additions to the TypeBeast
+ */
+declare class V6Client {
+    graphql<T = any>(options: GraphQLOptions, additionalHeaders?: {
+        [key: string]: string;
+    }): Observable<GraphqlSubscriptionResult<'', T>> | Promise<GraphQLResult<T>>;
+    query<FALLBACK_TYPES = unknown, TYPED_GQL_STRING extends string = string>(document: TYPED_GQL_STRING, queryParams?: GraphqlQueryParams<TYPED_GQL_STRING, FALLBACK_TYPES>, additionalHeaders?: {
+        [key: string]: string;
+    }): Promise<GraphqlQueryResult<TYPED_GQL_STRING, FALLBACK_TYPES>>;
+    mutate<FALLBACK_TYPES = unknown, TYPED_GQL_STRING extends string = string>(document: TYPED_GQL_STRING, queryParams?: GraphqlMutationParams<TYPED_GQL_STRING, FALLBACK_TYPES>, additionalHeaders?: {
+        [key: string]: string;
+    }): Promise<GraphqlMutationResult<TYPED_GQL_STRING, FALLBACK_TYPES>>;
+    subscribe<FALLBACK_TYPES = unknown, TYPED_GQL_STRING extends string = string>(document: TYPED_GQL_STRING, queryParams?: GraphqlSubscriptionParams<TYPED_GQL_STRING, FALLBACK_TYPES>, additionalHeaders?: {
+        [key: string]: string;
+    }): Observable<GraphqlSubscriptionResult<TYPED_GQL_STRING, FALLBACK_TYPES>>;
+}
+export declare function generateClient(): V6Client;
+export {};

package/lib-esm/v6.js

@@ -0,0 +1,42 @@
+import { __assign, __read } from "tslib";
+import { GraphQLAPI } from './GraphQLAPI';
+import { parse, print } from 'graphql';
+/**
+ * The proposed interface additions to the TypeBeast
+ */
+var V6Client = /** @class */ (function () {
+    function V6Client() {
+    }
+    V6Client.prototype.graphql = function (options, additionalHeaders) {
+        var parsedQuery = typeof options.query === 'string'
+            ? parse(options.query)
+            : parse(print(options.query));
+        var _a = __read(parsedQuery.definitions.filter(function (def) { return def.kind === 'OperationDefinition'; }), 1), _b = _a[0], operationDef = _b === void 0 ? {} : _b;
+        var operationType = operationDef.operation;
+        var childOptions = __assign(__assign({}, options), { query: print(parsedQuery) }); // todo
+        switch (operationType) {
+            case 'query':
+                return this.query(childOptions.query, childOptions, additionalHeaders);
+            case 'mutation':
+                return this.mutate(childOptions.query, childOptions, additionalHeaders);
+            case 'subscription':
+                return this.subscribe(childOptions.query, childOptions, additionalHeaders);
+            default:
+                throw new Error("invalid operation type: " + operationType);
+        }
+    };
+    V6Client.prototype.query = function (document, queryParams, additionalHeaders) {
+        return GraphQLAPI.graphql(__assign(__assign({}, (queryParams || {})), { query: document }), additionalHeaders);
+    };
+    V6Client.prototype.mutate = function (document, queryParams, additionalHeaders) {
+        return GraphQLAPI.graphql(__assign(__assign({}, (queryParams || {})), { query: document }), additionalHeaders);
+    };
+    V6Client.prototype.subscribe = function (document, queryParams, additionalHeaders) {
+        return GraphQLAPI.graphql(__assign(__assign({}, (queryParams || {})), { query: document }), additionalHeaders);
+    };
+    return V6Client;
+}());
+export function generateClient() {
+    return new V6Client();
+}
+//# sourceMappingURL=v6.js.map

package/lib-esm/v6.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"v6.js","sourceRoot":"","sources":["../src/v6.ts"],"names":[],"mappings":";AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1C,OAAO,EAAE,KAAK,EAAE,KAAK,EAA2B,MAAM,SAAS,CAAC;AAahE;;GAEG;AACH;IAAA;IAgFA,CAAC;IA/EA,0BAAO,GAAP,UACC,OAAuB,EACvB,iBAA6C;QAE7C,IAAM,WAAW,GAChB,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ;YAChC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YACtB,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC;QAE1B,IAAA,6GAEL,EAFM,UAAiB,EAAjB,sCAEN,CAAC;QACM,IAAA,sCAAwB,CACS;QAEzC,IAAM,YAAY,GAAG,sBACjB,OAAO,KACV,KAAK,EAAE,KAAK,CAAC,WAAW,CAAC,GAClB,CAAC,CAAC,OAAO;QAEjB,QAAQ,aAAa,EAAE;YACtB,KAAK,OAAO;gBACX,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC;YACxE,KAAK,UAAU;gBACd,OAAO,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,KAAK,EAAE,YAAY,EAAE,iBAAiB,CAAC,CAAC;YACzE,KAAK,cAAc;gBAClB,OAAO,IAAI,CAAC,SAAS,CACpB,YAAY,CAAC,KAAK,EAClB,YAAY,EACZ,iBAAiB,CACjB,CAAC;YACH;gBACC,MAAM,IAAI,KAAK,CAAC,6BAA2B,aAAe,CAAC,CAAC;SAC7D;IACF,CAAC;IAED,wBAAK,GAAL,UACC,QAA0B,EAC1B,WAAkE,EAClE,iBAA6C;QAE7C,OAAO,UAAU,CAAC,OAAO,uBAEnB,CAAC,WAAW,IAAI,EAAE,CAAS,KAC/B,KAAK,EAAE,QAAQ,KAEhB,iBAAiB,CACgD,CAAC;IACpE,CAAC;IAED,yBAAM,GAAN,UACC,QAA0B,EAC1B,WAAqE,EACrE,iBAA6C;QAE7C,OAAO,UAAU,CAAC,OAAO,uBAEnB,CAAC,WAAW,IAAI,EAAE,CAAS,KAC/B,KAAK,EAAE,QAAQ,KAEhB,iBAAiB,CACmD,CAAC;IACvE,CAAC;IAED,4BAAS,GAAT,UACC,QAA0B,EAC1B,WAAyE,EACzE,iBAA6C;QAE7C,OAAO,UAAU,CAAC,OAAO,uBAEnB,CAAC,WAAW,IAAI,EAAE,CAAS,KAC/B,KAAK,EAAE,QAAQ,KAEhB,iBAAiB,CAGjB,CAAC;IACH,CAAC;IACF,eAAC;AAAD,CAAC,AAhFD,IAgFC;AAED,MAAM,UAAU,cAAc;IAC7B,OAAO,IAAI,QAAQ,EAAE,CAAC;AACvB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aws-amplify/api-graphql",
-  "version": "3.4.3",
+  "version": "3.4.4-graphql-api-functional-options.2+627f308ed",
   "description": "Api-graphql category of aws-amplify",
   "main": "./lib/index.js",
   "module": "./lib-esm/index.js",
@@ -50,11 +50,11 @@
     "internals"
   ],
   "dependencies": {
-    "@aws-amplify/api-rest": "3.3.2",
-    "@aws-amplify/auth": "5.5.3",
-    "@aws-amplify/cache": "5.1.3",
-    "@aws-amplify/core": "5.5.2",
-    "@aws-amplify/pubsub": "5.3.3",
+    "@aws-amplify/api-rest": "3.3.3-graphql-api-functional-options.2+627f308ed",
+    "@aws-amplify/auth": "5.5.4-graphql-api-functional-options.2+627f308ed",
+    "@aws-amplify/cache": "5.1.4-graphql-api-functional-options.2+627f308ed",
+    "@aws-amplify/core": "5.5.3-graphql-api-functional-options.2+627f308ed",
+    "@aws-amplify/pubsub": "5.3.4-graphql-api-functional-options.2+627f308ed",
     "graphql": "15.8.0",
     "tslib": "^1.8.0",
     "uuid": "^3.2.1",
@@ -88,6 +88,9 @@
       "^.+\\.(js|jsx|ts|tsx)$": "ts-jest"
     },
     "testRegex": "(/__tests__/.*|\\.(test|spec))\\.(tsx?|jsx?)$",
+    "testPathIgnorePatterns": [
+      "__tests__/helpers/"
+    ],
     "moduleFileExtensions": [
       "ts",
       "tsx",
@@ -112,5 +115,5 @@
       "lib-esm"
     ]
   },
-  "gitHead": "b1061a190d11d1313e3c669dbeea79564cb6ea89"
+  "gitHead": "627f308ed709b6c0ab8ec750d7235f3e007a669a"
 }

package/src/facade-iterable-paging.ts

@@ -0,0 +1,150 @@
+import { GraphQLAPI } from './GraphQLAPI';
+import { Observable } from 'zen-observable-ts';
+import { parse, print, OperationDefinitionNode } from 'graphql';
+
+/**
+ * `GraphQLOptions` currently includes `{ query: string | DocumentNode, ... }`, but I'm thinking
+ * we swap that for `query: string` or `query: string | T extends Whatever`.
+ */
+import { GraphQLOptions } from './types';
+
+import {
+	GraphQLResult,
+	GraphqlQueryParams,
+	GraphqlQueryResult,
+	GraphqlMutationParams,
+	GraphqlMutationResult,
+	GraphqlSubscriptionParams,
+	GraphqlSubscriptionResult,
+} from './types/facade-iterable-paging';
+
+export function graphql<T = any>(
+	options: GraphQLOptions,
+	additionalHeaders?: { [key: string]: string }
+): Observable<GraphqlSubscriptionResult<'', T>> | Promise<GraphQLResult<T>> {
+	const parsedQuery =
+		typeof options.query === 'string'
+			? parse(options.query)
+			: parse(print(options.query));
+
+	const [operationDef = {}] = parsedQuery.definitions.filter(
+		def => def.kind === 'OperationDefinition'
+	);
+	const { operation: operationType } = operationDef as OperationDefinitionNode;
+
+	const childOptions = {
+		...options,
+		query: print(parsedQuery),
+	} as any;
+
+	switch (operationType) {
+		case 'query':
+			return query(childOptions.query, childOptions, additionalHeaders);
+		case 'mutation':
+			return mutate(childOptions.query, childOptions, additionalHeaders);
+		case 'subscription':
+			return subscribe(childOptions.query, childOptions, additionalHeaders);
+		default:
+			throw new Error(`invalid operation type: ${operationType}`);
+	}
+}
+
+export function query<
+	FALLBACK_TYPES = unknown,
+	TYPED_GQL_STRING extends string = string
+>(
+	document: TYPED_GQL_STRING,
+	queryParams?: GraphqlQueryParams<TYPED_GQL_STRING, FALLBACK_TYPES>,
+	additionalHeaders?: { [key: string]: string }
+): Promise<GraphqlQueryResult<TYPED_GQL_STRING, FALLBACK_TYPES>> {
+	return (
+		GraphQLAPI.graphql(
+			{
+				...((queryParams || {}) as any),
+				query: document,
+			},
+			additionalHeaders
+		) as any
+	).then(raw => {
+		const responseKey = raw.data ? Object.keys(raw.data)[0] : undefined;
+		if (responseKey) {
+			if (Array.isArray(raw.data[responseKey]?.items)) {
+				return {
+					data: (async function* _() {
+						for (const item of raw.data[responseKey]?.items) {
+							yield item;
+						}
+					})(),
+					errors: raw.errors,
+				};
+			} else {
+				return {
+					data: raw.data[responseKey],
+					errors: raw.errors,
+				};
+			}
+		} else {
+			return raw;
+		}
+	}) as Promise<GraphqlQueryResult<TYPED_GQL_STRING, FALLBACK_TYPES>>;
+}
+
+export function mutate<
+	FALLBACK_TYPES = unknown,
+	TYPED_GQL_STRING extends string = string
+>(
+	document: TYPED_GQL_STRING,
+	queryParams?: GraphqlMutationParams<TYPED_GQL_STRING, FALLBACK_TYPES>,
+	additionalHeaders?: { [key: string]: string }
+): Promise<GraphqlMutationResult<TYPED_GQL_STRING, FALLBACK_TYPES>> {
+	return (
+		GraphQLAPI.graphql(
+			{
+				...((queryParams || {}) as any),
+				query: document,
+			},
+			additionalHeaders
+		) as any
+	).then(raw => {
+		const responseKey = raw.data ? Object.keys(raw.data)[0] : undefined;
+		if (responseKey) {
+			return {
+				data: raw.data[responseKey],
+				errors: raw.errors,
+			};
+		} else {
+			return raw;
+		}
+	}) as Promise<GraphqlMutationResult<TYPED_GQL_STRING, FALLBACK_TYPES>>;
+}
+
+export function subscribe<
+	FALLBACK_TYPES = unknown,
+	TYPED_GQL_STRING extends string = string
+>(
+	document: TYPED_GQL_STRING,
+	queryParams?: GraphqlSubscriptionParams<TYPED_GQL_STRING, FALLBACK_TYPES>,
+	additionalHeaders?: { [key: string]: string }
+): Observable<GraphqlSubscriptionResult<TYPED_GQL_STRING, FALLBACK_TYPES>> {
+	return (
+		GraphQLAPI.graphql(
+			{
+				...((queryParams || {}) as any),
+				query: document,
+			},
+			additionalHeaders
+		) as Observable<any>
+	).map(raw => {
+		const messageKey = raw.value.data
+			? Object.keys(raw.value.data)[0]
+			: undefined;
+		return {
+			value: {
+				data: messageKey ? raw.value.data[messageKey] : undefined,
+				provider: raw.provider,
+			},
+		};
+	}) as unknown as Observable<
+		GraphqlSubscriptionResult<TYPED_GQL_STRING, FALLBACK_TYPES>
+	>;
+}

package/src/facade-light-flattening.ts

@@ -0,0 +1,139 @@
+import { GraphQLAPI } from './GraphQLAPI';
+import { Observable } from 'zen-observable-ts';
+import { parse, print, OperationDefinitionNode } from 'graphql';
+
+/**
+ * `GraphQLOptions` currently includes `{ query: string | DocumentNode, ... }`, but I'm thinking
+ * we swap that for `query: string` or `query: string | T extends Whatever`.
+ */
+import { GraphQLOptions } from './types';
+
+import {
+	GraphQLResult,
+	GraphqlQueryParams,
+	GraphqlQueryResult,
+	GraphqlMutationParams,
+	GraphqlMutationResult,
+	GraphqlSubscriptionParams,
+	GraphqlSubscriptionResult,
+} from './types/facade-light-flattening';
+
+export function graphql<T = any>(
+	options: GraphQLOptions,
+	additionalHeaders?: { [key: string]: string }
+): Observable<GraphqlSubscriptionResult<'', T>> | Promise<GraphQLResult<T>> {
+	const parsedQuery =
+		typeof options.query === 'string'
+			? parse(options.query)
+			: parse(print(options.query));
+
+	const [operationDef = {}] = parsedQuery.definitions.filter(
+		def => def.kind === 'OperationDefinition'
+	);
+	const { operation: operationType } = operationDef as OperationDefinitionNode;
+
+	const childOptions = {
+		...options,
+		query: print(parsedQuery),
+	} as any;
+
+	switch (operationType) {
+		case 'query':
+			return query(childOptions.query, childOptions, additionalHeaders);
+		case 'mutation':
+			return mutate(childOptions.query, childOptions, additionalHeaders);
+		case 'subscription':
+			return subscribe(childOptions.query, childOptions, additionalHeaders);
+		default:
+			throw new Error(`invalid operation type: ${operationType}`);
+	}
+}
+
+export function query<
+	FALLBACK_TYPES = unknown,
+	TYPED_GQL_STRING extends string = string
+>(
+	document: TYPED_GQL_STRING,
+	queryParams?: GraphqlQueryParams<TYPED_GQL_STRING, FALLBACK_TYPES>,
+	additionalHeaders?: { [key: string]: string }
+): Promise<GraphqlQueryResult<TYPED_GQL_STRING, FALLBACK_TYPES>> {
+	return (
+		GraphQLAPI.graphql(
+			{
+				...((queryParams || {}) as any),
+				query: document,
+			},
+			additionalHeaders
+		) as any
+	).then(raw => {
+		const responseKey = raw.data ? Object.keys(raw.data)[0] : undefined;
+		if (responseKey) {
+			return {
+				data: raw.data[responseKey],
+				errors: raw.errors,
+			};
+		} else {
+			return raw;
+		}
+	}) as Promise<GraphqlQueryResult<TYPED_GQL_STRING, FALLBACK_TYPES>>;
+}
+
+export function mutate<
+	FALLBACK_TYPES = unknown,
+	TYPED_GQL_STRING extends string = string
+>(
+	document: TYPED_GQL_STRING,
+	queryParams?: GraphqlMutationParams<TYPED_GQL_STRING, FALLBACK_TYPES>,
+	additionalHeaders?: { [key: string]: string }
+): Promise<GraphqlMutationResult<TYPED_GQL_STRING, FALLBACK_TYPES>> {
+	return (
+		GraphQLAPI.graphql(
+			{
+				...((queryParams || {}) as any),
+				query: document,
+			},
+			additionalHeaders
+		) as any
+	).then(raw => {
+		const responseKey = raw.data ? Object.keys(raw.data)[0] : undefined;
+		if (responseKey) {
+			return {
+				data: raw.data[responseKey],
+				errors: raw.errors,
+			};
+		} else {
+			return raw;
+		}
+	}) as Promise<GraphqlMutationResult<TYPED_GQL_STRING, FALLBACK_TYPES>>;
+}
+
+export function subscribe<
+	FALLBACK_TYPES = unknown,
+	TYPED_GQL_STRING extends string = string
+>(
+	document: TYPED_GQL_STRING,
+	queryParams?: GraphqlSubscriptionParams<TYPED_GQL_STRING, FALLBACK_TYPES>,
+	additionalHeaders?: { [key: string]: string }
+): Observable<GraphqlSubscriptionResult<TYPED_GQL_STRING, FALLBACK_TYPES>> {
+	return (
+		GraphQLAPI.graphql(
+			{
+				...((queryParams || {}) as any),
+				query: document,
+			},
+			additionalHeaders
+		) as Observable<any>
+	).map(raw => {
+		const messageKey = raw.value.data
+			? Object.keys(raw.value.data)[0]
+			: undefined;
+		return {
+			value: {
+				data: messageKey ? raw.value.data[messageKey] : undefined,
+				provider: raw.provider,
+			},
+		};
+	}) as unknown as Observable<
+		GraphqlSubscriptionResult<TYPED_GQL_STRING, FALLBACK_TYPES>
+	>;
+}

package/src/facade-no-flattening.ts

@@ -0,0 +1,100 @@
+import { GraphQLAPI } from './GraphQLAPI';
+import { Observable } from 'zen-observable-ts';
+import { parse, print, OperationDefinitionNode } from 'graphql';
+
+/**
+ * `GraphQLOptions` currently includes `{ query: string | DocumentNode, ... }`, but I'm thinking
+ * we swap that for `query: string` or `query: string | T extends Whatever`.
+ */
+import { GraphQLOptions, GraphQLResult } from './types';
+
+import {
+	GraphqlQueryParams,
+	GraphqlQueryResult,
+	GraphqlMutationParams,
+	GraphqlMutationResult,
+	GraphqlSubscriptionParams,
+	GraphqlSubscriptionResult,
+} from './types/facade-no-flattening';
+
+export function graphql<T = any>(
+	options: GraphQLOptions,
+	additionalHeaders?: { [key: string]: string }
+): Observable<GraphqlSubscriptionResult<'', T>> | Promise<GraphQLResult<T>> {
+	const parsedQuery =
+		typeof options.query === 'string'
+			? parse(options.query)
+			: parse(print(options.query));
+
+	const [operationDef = {}] = parsedQuery.definitions.filter(
+		def => def.kind === 'OperationDefinition'
+	);
+	const { operation: operationType } = operationDef as OperationDefinitionNode;
+
+	const childOptions = {
+		...options,
+		query: print(parsedQuery),
+	} as any; // todo
+
+	switch (operationType) {
+		case 'query':
+			return query(childOptions.query, childOptions, additionalHeaders);
+		case 'mutation':
+			return mutate(childOptions.query, childOptions, additionalHeaders);
+		case 'subscription':
+			return subscribe(childOptions.query, childOptions, additionalHeaders);
+		default:
+			throw new Error(`invalid operation type: ${operationType}`);
+	}
+}
+
+export function query<
+	FALLBACK_TYPES = unknown,
+	TYPED_GQL_STRING extends string = string
+>(
+	document: TYPED_GQL_STRING,
+	queryParams?: GraphqlQueryParams<TYPED_GQL_STRING, FALLBACK_TYPES>,
+	additionalHeaders?: { [key: string]: string }
+): Promise<GraphqlQueryResult<TYPED_GQL_STRING, FALLBACK_TYPES>> {
+	return GraphQLAPI.graphql(
+		{
+			...((queryParams || {}) as any), // todo
+			query: document,
+		},
+		additionalHeaders
+	) as Promise<GraphqlQueryResult<TYPED_GQL_STRING, FALLBACK_TYPES>>;
+}
+
+export function mutate<
+	FALLBACK_TYPES = unknown,
+	TYPED_GQL_STRING extends string = string
+>(
+	document: TYPED_GQL_STRING,
+	queryParams?: GraphqlMutationParams<TYPED_GQL_STRING, FALLBACK_TYPES>,
+	additionalHeaders?: { [key: string]: string }
+): Promise<GraphqlMutationResult<TYPED_GQL_STRING, FALLBACK_TYPES>> {
+	return GraphQLAPI.graphql(
+		{
+			...((queryParams || {}) as any), // todo
+			query: document,
+		},
+		additionalHeaders
+	) as Promise<GraphqlMutationResult<TYPED_GQL_STRING, FALLBACK_TYPES>>;
+}
+
+export function subscribe<
+	FALLBACK_TYPES = unknown,
+	TYPED_GQL_STRING extends string = string
+>(
+	document: TYPED_GQL_STRING,
+	queryParams?: GraphqlSubscriptionParams<TYPED_GQL_STRING, FALLBACK_TYPES>,
+	additionalHeaders?: { [key: string]: string }
+): Observable<GraphqlSubscriptionResult<TYPED_GQL_STRING, FALLBACK_TYPES>> {
+	return GraphQLAPI.graphql(
+		{
+			...((queryParams || {}) as any), // todo
+			query: document,
+		},
+		additionalHeaders
+	) as Observable<GraphqlSubscriptionResult<TYPED_GQL_STRING, FALLBACK_TYPES>>;
+}