Add GraphQL typing

Signed-off-by: Alan Cha <[email protected]>

Author: Alan-Cha

packages/openapi-to-graphql/README.md

@@ -170,7 +170,7 @@ Schema options:
 
 Resolver options:
 
-- `headers` (type: `object` | `function`, default: `{}`): Headers to be sent in every request to the API described by the given OAS. Parameters defined in the OpenAPI Specification to set these headers will be ignored by OpenAPI-to-GraphQL. If used as a function, the following parameters will be exposed per-request: `req` (the GraphQL resolver's context.request object), `method`, `path`, and `title`.
+- `headers` (type: `object` | `function`, default: `{}`): Headers to be sent in every request to the API described by the given OAS. Parameters defined in the OpenAPI Specification to set these headers will be ignored by OpenAPI-to-GraphQL. If used as a function, the following parameters will be exposed per-request: `req` (the GraphQL resolver's `context.request` object), the operation's `method`, the operation's `path`, and the API `title`.
 
 - `qs` (type: `object`, default: `{}`): Query parameters to be sent in every request to the API described by the given OAS. Parameters defined in the OpenAPI Specification to set these query parameters will be ignored by OpenAPI-to-GraphQL.
 

packages/openapi-to-graphql/lib/auth_builder.d.ts

@@ -2,12 +2,12 @@
  * Functions to create viewers that allow users to pass credentials to resolve
  * functions used by OpenAPI-to-GraphQL.
  */
-import { GraphQLObjectType as GQObjectType } from 'graphql';
-import { Args, ResolveFunction, GraphQLOperationType } from './types/graphql';
+import { GraphQLObjectType, GraphQLFieldResolver } from 'graphql';
+import { Args, GraphQLOperationType } from './types/graphql';
 import { PreprocessingData } from './types/preprocessing_data';
-declare type Viewer = {
-    type: GQObjectType;
-    resolve: ResolveFunction;
+declare type Viewer<TSource, TContext, TArgs> = {
+    type: GraphQLObjectType;
+    resolve: GraphQLFieldResolver<TSource, TContext, TArgs>;
     args: Args;
     description: string;
 };
@@ -17,7 +17,7 @@ declare type Viewer = {
  * i.e. inside either rootQueryFields/rootMutationFields or inside
  * rootQueryFields/rootMutationFields for further processing
  */
-export declare function createAndLoadViewer(queryFields: object, operationType: GraphQLOperationType, data: PreprocessingData): {
-    [key: string]: Viewer;
+export declare function createAndLoadViewer<TSource, TContext, TArgs>(queryFields: object, operationType: GraphQLOperationType, data: PreprocessingData<TSource, TContext, TArgs>): {
+    [key: string]: Viewer<TSource, TContext, TArgs>;
 };
 export {};

packages/openapi-to-graphql/lib/auth_builder.js

@@ -1,8 +1,8 @@
 /**
  * Utilities related to GraphQL.
  */
-import { GraphQLObjectType as GQObjectType } from 'graphql';
+import { GraphQLObjectType } from 'graphql';
 /**
  * Returns empty GraphQLObjectType.
  */
-export declare function getEmptyObjectType(name: string): GQObjectType;
+export declare function getEmptyObjectType(name: string): GraphQLObjectType;

packages/openapi-to-graphql/lib/auth_builder.js.map

@@ -35,6 +35,6 @@ declare type Result = {
 /**
  * Creates a GraphQL interface from the given OpenAPI Specification (2 or 3).
  */
-export declare function createGraphQLSchema(spec: Oas3 | Oas2 | (Oas3 | Oas2)[], options?: Options): Promise<Result>;
+export declare function createGraphQLSchema<TSource, TContext, TArgs>(spec: Oas3 | Oas2 | (Oas3 | Oas2)[], options?: Options<TSource, TContext, TArgs>): Promise<Result>;
 export { sanitize, CaseStyle } from './oas_3_tools';
 export { GraphQLOperationType } from './types/graphql';