Synchronous version

docs/api-graphql-project-config.md

@@ -102,12 +102,28 @@ _type: `getSchema(out: 'GraphQLSchema'): Promise<GraphQLSchema>`_
 
 Allows to access `GraphQLSchema` object based on provided information (in `schema` property of project's configuration).
 
+### `getSchemaSync()`
+
+_type: `getSchemaSync(): GraphQLSchema`_
+
+_type: `getSchemaSync(out: 'DocumentNode'): DocumentNode`_
+
+_type: `getSchemaSync(out: 'GraphQLSchema'): GraphQLSchema`_
+
+Allows to access `GraphQLSchema` object based on provided information (in `schema` property of project's configuration).
+
 ### `getDocuments()`
 
 _type: `getDocuments(): Promise<Source[]>`_
 
 Access Operations and Fragments wrapped with `Source` class based on provided information (in `documents` property of project's configuration).
 
+### `getDocumentsSync()`
+
+_type: `getDocumentsSync(): Source[]`_
+
+Access Operations and Fragments wrapped with `Source` class based on provided information (in `documents` property of project's configuration).
+
 ### `match()`
 
 _type: `match(filepath: string): boolean`_

docs/author-extensions.md

@@ -39,6 +39,8 @@ async function main() {
 }
 ```
 
+> Synchronous version: `loadConfigSync`
+
 Now that everything is ready, GraphQL Config understands there's the Inspector extension.
 
 In order to access information stored in the config file, do the following:

docs/author-load-config.md

@@ -8,7 +8,7 @@ sidebar_label: Loading Config
 
 This function is the starting point for using GraphQL Config. It looks for a config file in [predefined search places](./user-usage.md#config-search-places) in the currently working directory.
 
-A basic usage example:
+A basic usage example (async):
 
 ```typescript
 import {loadConfig} from 'graphql-config';
@@ -18,6 +18,16 @@ async function main() {
 }
 ```
 
+Synchronous version:
+
+```typescript
+import {loadConfigSync} from 'graphql-config';
+
+function main() {
+  const config = loadConfigSync({...}); // an instance of GraphQLConfig
+}
+```
+
 ## Options
 
 ### `filepath`

docs/user-usage.md

@@ -6,12 +6,17 @@ sidebar_label: Usage
 
 ## Config search places
 
+- `graphql.config.json`
+- `graphql.config.js`
+- `graphql.config.yaml`
+- `graphql.config.yml`
+
 - `.graphqlrc` _(YAML and JSON)_
 - `.graphqlrc.json`
 - `.graphqlrc.yaml`
 - `.graphqlrc.yml`
 - `.graphqlrc.js`
-- `graphql.config.js`
+
 - `graphql` property in `package.json`
 
 ## Schema

package.json

@@ -33,12 +33,12 @@
     "graphql": "^0.11.0 || ^0.12.0 || ^0.13.0 || ^14.0.0"
   },
   "dependencies": {
-    "@graphql-toolkit/common": "0.9.9",
-    "@graphql-toolkit/core": "0.9.9",
-    "@graphql-toolkit/graphql-file-loader": "0.9.7",
-    "@graphql-toolkit/json-file-loader": "0.9.7",
-    "@graphql-toolkit/schema-merging": "0.9.9",
-    "@graphql-toolkit/url-loader": "0.9.7",
+    "@graphql-toolkit/common": "0.9.8-alpha-6be3bfe.44+6be3bfe",
+    "@graphql-toolkit/core": "0.9.8-alpha-6be3bfe.44+6be3bfe",
+    "@graphql-toolkit/graphql-file-loader": "0.9.8-alpha-6be3bfe.44+6be3bfe",
+    "@graphql-toolkit/json-file-loader": "0.9.8-alpha-6be3bfe.44+6be3bfe",
+    "@graphql-toolkit/schema-merging": "0.9.8-alpha-6be3bfe.44+6be3bfe",
+    "@graphql-toolkit/url-loader": "0.9.8-alpha-6be3bfe.44+6be3bfe",
     "cosmiconfig": "6.0.0",
     "globby": "11.0.0",
     "minimatch": "3.0.4"

src/config.ts

@@ -6,6 +6,8 @@ import {
   isSingleProjectConfig,
   findConfig,
   getConfig,
+  getConfigSync,
+  findConfigSync,
 } from './helpers';
 import {
   ProjectNotFoundError,
@@ -30,14 +32,27 @@ interface LoadConfigOptions {
   configName?: string;
 }
 
-export async function loadConfig({
-  filepath,
-  rootDir = cwd,
-  extensions = [],
-  throwOnMissing = true,
-  throwOnEmpty = true,
-  configName = defaultConfigName,
-}: LoadConfigOptions) {
+const defaultLoadConfigOptions: LoadConfigOptions = {
+  rootDir: cwd,
+  extensions: [],
+  throwOnMissing: true,
+  throwOnEmpty: true,
+  configName: defaultConfigName,
+};
+
+export async function loadConfig(options: LoadConfigOptions): Promise<GraphQLConfig | undefined> {
+  const {
+    filepath,
+    configName,
+    rootDir,
+    extensions,
+    throwOnEmpty,
+    throwOnMissing,
+  } = {
+    ...defaultLoadConfigOptions,
+    ...options,
+  };
+
   try {
     const found = filepath
       ? await getConfig({
@@ -51,17 +66,54 @@ export async function loadConfig({
 
     return new GraphQLConfig(found, extensions);
   } catch (error) {
-    if (
-      (!throwOnMissing && error instanceof ConfigNotFoundError) ||
-      (!throwOnEmpty && error instanceof ConfigEmptyError)
-    ) {
-      return;
-    }
+    return handleError(error, {throwOnMissing, throwOnEmpty});
+  }
+}
+
+export async function loadConfigSync(options: LoadConfigOptions) {
+  const {
+    filepath,
+    configName,
+    rootDir,
+    extensions,
+    throwOnEmpty,
+    throwOnMissing,
+  } = {
+    ...defaultLoadConfigOptions,
+    ...options,
+  };
 
-    throw error;
+  try {
+    const found = filepath
+      ? getConfigSync({
+          filepath,
+          configName,
+        })
+      : findConfigSync({
+          rootDir,
+          configName,
+        });
+
+    return new GraphQLConfig(found, extensions);
+  } catch (error) {
+    return handleError(error, {throwOnMissing, throwOnEmpty});
   }
 }
 
+function handleError(
+  error: any,
+  options: Pick<LoadConfigOptions, 'throwOnMissing' | 'throwOnEmpty'>,
+): never | undefined {
+  if (
+    (!options.throwOnMissing && error instanceof ConfigNotFoundError) ||
+    (!options.throwOnEmpty && error instanceof ConfigEmptyError)
+  ) {
+    return;
+  }
+
+  throw error;
+}
+
 export class GraphQLConfig {
   private readonly _rawConfig: IGraphQLConfig;
 
@@ -84,7 +136,7 @@ export class GraphQLConfig {
     this.extensions = new GraphQLExtensionsRegistry({cwd: this.dirpath});
 
     // Register Endpoints
-    this.extensions.register(EndpointsExtension)
+    this.extensions.register(EndpointsExtension);
 
     extensions.forEach(extension => {
       this.extensions.register(extension);