fix(graphql): add info on how to migrate, import only from root files

Author: kamilmysliwiec

packages/apollo/lib/drivers/apollo-base.driver.ts

@@ -1,7 +1,7 @@
 import { HttpStatus } from '@nestjs/common';
 import { loadPackage } from '@nestjs/common/utils/load-package.util';
 import { isFunction } from '@nestjs/common/utils/shared.utils';
-import { AbstractGraphQLDriver } from '@nestjs/graphql/drivers/abstract-graphql.driver';
+import { AbstractGraphQLDriver } from '@nestjs/graphql';
 import {
   ApolloError,
   ApolloServerBase,

packages/apollo/lib/drivers/apollo-federation.driver.ts

@@ -1,8 +1,7 @@
 import { Injectable } from '@nestjs/common';
 import { loadPackage } from '@nestjs/common/utils/load-package.util';
 import { ModulesContainer } from '@nestjs/core';
-import { GraphQLFederationFactory } from '@nestjs/graphql/federation/graphql-federation.factory';
-import { extend } from '@nestjs/graphql/utils/extend.util';
+import { extend, GraphQLFederationFactory } from '@nestjs/graphql';
 import { ApolloDriverConfig } from '../interfaces';
 import { PluginsExplorerService } from '../services/plugins-explorer.service';
 import { ApolloBaseDriver } from './apollo-base.driver';

packages/apollo/lib/drivers/apollo.driver.ts

@@ -1,7 +1,10 @@
 import { Injectable } from '@nestjs/common';
 import { ModulesContainer } from '@nestjs/core';
-import { GqlSubscriptionService, SubscriptionConfig } from '@nestjs/graphql';
-import { extend } from '@nestjs/graphql/utils';
+import {
+  extend,
+  GqlSubscriptionService,
+  SubscriptionConfig,
+} from '@nestjs/graphql';
 import { printSchema } from 'graphql';
 import { ApolloDriverConfig } from '../interfaces';
 import { PluginsExplorerService } from '../services/plugins-explorer.service';

packages/apollo/lib/services/plugins-explorer.service.ts

@@ -1,7 +1,6 @@
 import { InstanceWrapper } from '@nestjs/core/injector/instance-wrapper';
 import { ModulesContainer } from '@nestjs/core/injector/modules-container';
-import { GqlModuleOptions } from '@nestjs/graphql/interfaces/gql-module-options.interface';
-import { BaseExplorerService } from '@nestjs/graphql/services/base-explorer.service';
+import { BaseExplorerService, GqlModuleOptions } from '@nestjs/graphql';
 import { PLUGIN_METADATA } from '../apollo.constants';
 
 export class PluginsExplorerService extends BaseExplorerService {

packages/graphql/lib/graphql.module.ts

@@ -1,4 +1,4 @@
-import { Inject, Module } from '@nestjs/common';
+import { Inject, Logger, Module } from '@nestjs/common';
 import {
   DynamicModule,
   OnModuleDestroy,
@@ -48,6 +48,8 @@ export class GraphQLModule<
   TAdapter extends AbstractGraphQLDriver = AbstractGraphQLDriver,
 > implements OnModuleInit, OnModuleDestroy
 {
+  private static readonly logger = new Logger('GraphQLModule');
+
   get graphQlAdapter(): TAdapter {
     return this._graphQlAdapter as TAdapter;
   }
@@ -59,9 +61,15 @@ export class GraphQLModule<
     private readonly graphQlTypesLoader: GraphQLTypesLoader,
   ) {}
 
+  async onModuleDestroy() {
+    await this._graphQlAdapter.stop();
+  }
+
   static forRoot<TOptions extends Record<string, any> = GqlModuleOptions>(
     options: TOptions = {} as TOptions,
   ): DynamicModule {
+    this.assertDriver(options);
+
     return {
       module: GraphQLModule,
       providers: [
@@ -80,6 +88,7 @@ export class GraphQLModule<
   static forRootAsync<TOptions extends Record<string, any> = GqlModuleOptions>(
     options: GqlModuleAsyncOptions<TOptions, GqlOptionsFactory<TOptions>>,
   ): DynamicModule {
+    this.assertDriver(options);
     return {
       module: GraphQLModule,
       imports: options.imports,
@@ -150,7 +159,12 @@ export class GraphQLModule<
     });
   }
 
-  async onModuleDestroy() {
-    await this._graphQlAdapter.stop();
+  private static assertDriver(options: Record<string, any>) {
+    if (!options.driver) {
+      const errorMessage =
+        'Missing "driver" option. In the latest version of "@nestjs/graphql" package (v10) a new required configuration property called "driver" has been introduced. Check out the official documentation for more details on how to migrate ("Quick start" chapter).';
+      this.logger.error(errorMessage);
+      throw new Error(errorMessage);
+    }
   }
 }

packages/graphql/lib/index.ts

@@ -10,9 +10,11 @@ export * from './graphql.module';
 export * from './interfaces';
 export * from './scalars';
 export * from './schema-builder';
+export * from './services/base-explorer.service';
 export * from './services/gql-arguments-host';
 export * from './services/gql-execution-context';
 export * from './services/gql-subscription.service';
 export * from './tokens';
 export * from './type-factories';
 export * from './type-helpers';
+export * from './utils/extend.util';