chore: v14.0.0 release

packages/apollo/lib/constants/index.ts

@@ -1 +1 @@
-export * from './apollo.constants';
+export * from './apollo.constants.js';

packages/apollo/lib/decorators/index.ts

@@ -1 +1 @@
-export * from './plugin.decorator';
+export * from './plugin.decorator.js';

packages/apollo/lib/decorators/plugin.decorator.ts

@@ -1,5 +1,5 @@
 import { SetMetadata } from '@nestjs/common';
-import { PLUGIN_METADATA } from '../constants';
+import { PLUGIN_METADATA } from '../constants/index.js';
 
 /**
  * Decorator that marks a class as an Apollo plugin.

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

@@ -1,21 +1,20 @@
 import { ApolloServer, type BaseContext } from '@apollo/server';
-import { ApolloServerPluginLandingPageGraphQLPlayground } from '@apollo/server-plugin-landing-page-graphql-playground';
 import {
   ApolloServerErrorCode,
   unwrapResolverError,
 } from '@apollo/server/errors';
 import { ApolloServerPluginLandingPageDisabled } from '@apollo/server/plugin/disabled';
 import { ApolloServerPluginDrainHttpServer } from '@apollo/server/plugin/drainHttpServer';
 import { HttpStatus } from '@nestjs/common';
-import { loadPackage } from '@nestjs/common/utils/load-package.util';
-import { isFunction } from '@nestjs/common/utils/shared.utils';
+import { loadPackage } from '@nestjs/common/utils/load-package.util.js';
+import { isFunction } from '@nestjs/common/utils/shared.utils.js';
 import { AbstractGraphQLDriver } from '@nestjs/graphql';
 import { GraphQLError, GraphQLFormattedError } from 'graphql';
 import omit from 'lodash.omit';
-import { GraphiQLPlaygroundPlugin } from '../graphiql/graphiql-playground.plugin';
-import { GraphiQLOptions } from '../graphiql/interfaces/graphiql-options.interface';
-import { ApolloDriverConfig } from '../interfaces';
-import { createAsyncIterator } from '../utils/async-iterator.util';
+import { GraphiQLPlaygroundPlugin } from '../graphiql/graphiql-playground.plugin.js';
+import { GraphiQLOptions } from '../graphiql/interfaces/graphiql-options.interface.js';
+import { ApolloDriverConfig } from '../interfaces/index.js';
+import { createAsyncIterator } from '../utils/async-iterator.util.js';
 
 const apolloPredefinedExceptions: Partial<Record<HttpStatus, string>> = {
   [HttpStatus.BAD_REQUEST]: ApolloServerErrorCode.BAD_REQUEST,
@@ -57,7 +56,14 @@ export abstract class ApolloBaseDriver<
       stopOnTerminationSignals: false,
     };
 
-    if (options.graphiql) {
+    const useGraphiQL =
+      options.graphiql ||
+      options.playground === true ||
+      (options.graphiql === undefined &&
+        options.playground === undefined &&
+        process.env.NODE_ENV !== 'production');
+
+    if (useGraphiQL) {
       const graphiQlPlaygroundOpts: GraphiQLOptions =
         typeof options.graphiql === 'object' ? options.graphiql : {};
       graphiQlPlaygroundOpts.url ??= options.path;
@@ -66,21 +72,6 @@ export abstract class ApolloBaseDriver<
         ...defaults,
         plugins: [new GraphiQLPlaygroundPlugin(graphiQlPlaygroundOpts)],
       };
-    } else if (
-      (options.playground === undefined &&
-        process.env.NODE_ENV !== 'production') ||
-      options.playground
-    ) {
-      const playgroundOptions =
-        typeof options.playground === 'object' ? options.playground : undefined;
-      defaults = {
-        ...defaults,
-        plugins: [
-          ApolloServerPluginLandingPageGraphQLPlayground(
-            playgroundOptions,
-          ) as any,
-        ],
-      };
     } else if (
       (options.playground === undefined &&
         process.env.NODE_ENV === 'production') ||
@@ -101,6 +92,7 @@ export abstract class ApolloBaseDriver<
       defaults.plugins || [],
     );
 
+    this.normalizeSubscriptionsPath(options);
     this.wrapContextResolver(options);
     this.wrapFormatErrorFn(options);
 
@@ -113,6 +105,22 @@ export abstract class ApolloBaseDriver<
     return options;
   }
 
+  private normalizeSubscriptionsPath(options: T) {
+    const subscriptions = (options as ApolloDriverConfig).subscriptions;
+    if (!subscriptions) {
+      return;
+    }
+    for (const protocol of [
+      'graphql-ws',
+      'subscriptions-transport-ws',
+    ] as const) {
+      const config = subscriptions[protocol];
+      if (config && typeof config === 'object' && config.path) {
+        config.path = this.applyGlobalPrefix(config.path, options);
+      }
+    }
+  }
+
   public subscriptionWithFilter(
     instanceRef: unknown,
     filterFn: (
@@ -134,7 +142,7 @@ export abstract class ApolloBaseDriver<
     options: T,
     { preStartHook }: { preStartHook?: () => void } = {},
   ) {
-    const { expressMiddleware } = loadPackage(
+    const { expressMiddleware } = await loadPackage(
       '@as-integrations/express5',
       'GraphQLModule',
       () => require('@as-integrations/express5'),
@@ -144,7 +152,7 @@ export abstract class ApolloBaseDriver<
 
     const httpAdapter = this.httpAdapterHost.httpAdapter;
 
-    // Workaround: GraphQL playground requires body to be present
+    // Workaround: the landing page requires body to be present
     // otherwise, it shows the "req.body is not set; this probably means you forgot to set up the json middleware before the Apollo Server middleware." error.
     // The latest version of "body-parser" does not set the body if there is no payload.
     // @see https://github.com/nestjs/graphql/issues/3451
@@ -187,11 +195,10 @@ export abstract class ApolloBaseDriver<
     options: T,
     { preStartHook }: { preStartHook?: () => void } = {},
   ) {
-    const { fastifyApolloDrainPlugin, fastifyApolloHandler } = loadPackage(
-      '@as-integrations/fastify',
-      'GraphQLModule',
-      () => require('@as-integrations/fastify'),
-    );
+    const { fastifyApolloDrainPlugin, fastifyApolloHandler } =
+      await loadPackage('@as-integrations/fastify', 'GraphQLModule', () =>
+        require('@as-integrations/fastify'),
+      );
 
     const httpAdapter = this.httpAdapterHost.httpAdapter;
     const app = httpAdapter.getInstance();

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

@@ -1,5 +1,5 @@
 import { Injectable } from '@nestjs/common';
-import { loadPackage } from '@nestjs/common/utils/load-package.util';
+import { loadPackage } from '@nestjs/common/utils/load-package.util.js';
 import { ModulesContainer } from '@nestjs/core';
 import {
   extend,
@@ -8,9 +8,9 @@ import {
   SubscriptionConfig,
 } from '@nestjs/graphql';
 import { GraphQLSchema } from 'graphql';
-import { ApolloDriverConfig } from '../interfaces';
-import { PluginsExplorerService } from '../services/plugins-explorer.service';
-import { ApolloBaseDriver } from './apollo-base.driver';
+import { ApolloDriverConfig } from '../interfaces/index.js';
+import { PluginsExplorerService } from '../services/plugins-explorer.service.js';
+import { ApolloBaseDriver } from './apollo-base.driver.js';
 
 /**
  * @publicApi
@@ -35,7 +35,7 @@ export class ApolloFederationDriver extends ApolloBaseDriver {
     );
 
     if (options.definitions && options.definitions.path) {
-      const { printSubgraphSchema } = loadPackage(
+      const { printSubgraphSchema } = await loadPackage(
         '@apollo/subgraph',
         'ApolloFederation',
         () => require('@apollo/subgraph'),
@@ -50,7 +50,7 @@ export class ApolloFederationDriver extends ApolloBaseDriver {
 
     if (options.installSubscriptionHandlers || options.subscriptions) {
       const subscriptionsOptions: SubscriptionConfig =
-        options.subscriptions || { 'subscriptions-transport-ws': {} };
+        options.subscriptions || { 'graphql-ws': {} };
       this._subscriptionService = new GqlSubscriptionService(
         {
           schema: options.schema!,

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

@@ -1,11 +1,11 @@
 import { Injectable } from '@nestjs/common';
-import { loadPackage } from '@nestjs/common/utils/load-package.util';
+import { loadPackage } from '@nestjs/common/utils/load-package.util.js';
 import { ModulesContainer } from '@nestjs/core';
 import { extend } from '@nestjs/graphql';
 import { GraphQLSchema } from 'graphql';
-import { ApolloGatewayDriverConfig } from '../interfaces';
-import { PluginsExplorerService } from '../services/plugins-explorer.service';
-import { ApolloBaseDriver } from './apollo-base.driver';
+import { ApolloGatewayDriverConfig } from '../interfaces/index.js';
+import { PluginsExplorerService } from '../services/plugins-explorer.service.js';
+import { ApolloBaseDriver } from './apollo-base.driver.js';
 
 /**
  *  @publicApi
@@ -26,7 +26,7 @@ export class ApolloGatewayDriver extends ApolloBaseDriver<ApolloGatewayDriverCon
       this.pluginsExplorerService.explore(options),
     );
 
-    const { ApolloGateway } = loadPackage(
+    const { ApolloGateway } = await loadPackage(
       '@apollo/gateway',
       'ApolloGateway',
       () => require('@apollo/gateway'),

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

@@ -6,9 +6,9 @@ import {
   SubscriptionConfig,
 } from '@nestjs/graphql';
 import { printSchema } from 'graphql';
-import { ApolloDriverConfig } from '../interfaces';
-import { PluginsExplorerService } from '../services/plugins-explorer.service';
-import { ApolloBaseDriver } from './apollo-base.driver';
+import { ApolloDriverConfig } from '../interfaces/index.js';
+import { PluginsExplorerService } from '../services/plugins-explorer.service.js';
+import { ApolloBaseDriver } from './apollo-base.driver.js';
 
 /**
  *  @publicApi
@@ -40,7 +40,7 @@ export class ApolloDriver extends ApolloBaseDriver {
 
     if (options.installSubscriptionHandlers || options.subscriptions) {
       const subscriptionsOptions: SubscriptionConfig =
-        options.subscriptions || { 'subscriptions-transport-ws': {} };
+        options.subscriptions || { 'graphql-ws': {} };
       this._subscriptionService = new GqlSubscriptionService(
         {
           schema: options.schema!,

packages/apollo/lib/drivers/index.ts

@@ -1,3 +1,3 @@
-export * from './apollo-federation.driver';
-export * from './apollo-gateway.driver';
-export * from './apollo.driver';
+export * from './apollo-federation.driver.js';
+export * from './apollo-gateway.driver.js';
+export * from './apollo.driver.js';

packages/apollo/lib/errors/index.ts

@@ -1,4 +1,4 @@
-export * from './authentication.error';
-export * from './forbidden.error';
-export * from './user-input.error';
-export * from './validation.error';
+export * from './authentication.error.js';
+export * from './forbidden.error.js';
+export * from './user-input.error.js';
+export * from './validation.error.js';

packages/apollo/lib/graphiql/graphiql-html.factory.ts

@@ -1,4 +1,4 @@
-import { GraphiQLOptions } from './interfaces/graphiql-options.interface';
+import { GraphiQLOptions } from './interfaces/graphiql-options.interface.js';
 
 export class GraphiQLHTMLFactory {
   create(options: GraphiQLOptions): string {

packages/apollo/lib/graphiql/graphiql-playground.plugin.ts

@@ -1,6 +1,6 @@
 import { ApolloServerPlugin } from '@apollo/server';
-import { GraphiQLHTMLFactory } from './graphiql-html.factory';
-import { GraphiQLOptions } from './interfaces/graphiql-options.interface';
+import { GraphiQLHTMLFactory } from './graphiql-html.factory.js';
+import { GraphiQLOptions } from './interfaces/graphiql-options.interface.js';
 
 export class GraphiQLPlaygroundPlugin implements ApolloServerPlugin {
   private readonly graphiqlHTMLFactory = new GraphiQLHTMLFactory();

packages/apollo/lib/index.ts

@@ -1,6 +1,6 @@
-export * from './decorators';
-export * from './drivers';
-export * from './errors';
-export * from './interfaces';
-export * from './utils';
-export * from './services';
+export * from './decorators/index.js';
+export * from './drivers/index.js';
+export * from './errors/index.js';
+export * from './interfaces/index.js';
+export * from './utils/index.js';
+export * from './services/index.js';

packages/apollo/lib/interfaces/apollo-driver-config.interface.ts

@@ -1,12 +1,11 @@
 import { ApolloServerOptionsWithTypeDefs } from '@apollo/server';
-import { ApolloServerPluginLandingPageGraphQLPlaygroundOptions } from '@apollo/server-plugin-landing-page-graphql-playground';
 import {
   GqlModuleAsyncOptions,
   GqlModuleOptions,
   GqlOptionsFactory,
   SubscriptionConfig,
 } from '@nestjs/graphql';
-import { GraphiQLOptions } from '../graphiql/interfaces/graphiql-options.interface';
+import { GraphiQLOptions } from '../graphiql/interfaces/graphiql-options.interface.js';
 
 /**
  *  @publicApi
@@ -29,7 +28,7 @@ export interface ApolloDriverConfig
     ServerRegistration,
     GqlModuleOptions {
   /**
-   * If enabled, "subscriptions-transport-ws" will be automatically registered.
+   * If enabled, graphql-ws will be automatically registered.
    */
   installSubscriptionHandlers?: boolean;
 
@@ -39,13 +38,14 @@ export interface ApolloDriverConfig
   subscriptions?: SubscriptionConfig;
 
   /**
-   * GraphQL playground options.
-   * The built-in playground is deprecated and will be replaced with GraphiQL in the future.
+   * Deprecated boolean alias for GraphiQL.
+   * Set to `true` to enable GraphiQL, or `false` to disable the landing page.
    */
-  playground?: boolean | ApolloServerPluginLandingPageGraphQLPlaygroundOptions;
+  playground?: boolean;
 
   /**
    * GraphiQL options, or a boolean to enable GraphiQL with default options.
+   * GraphiQL is enabled by default in non-production when neither landing page option is configured.
    */
   graphiql?: boolean | GraphiQLOptions;
 

packages/apollo/lib/interfaces/apollo-federation-driver-config.interface.ts

@@ -2,7 +2,7 @@ import {
   ApolloDriverAsyncConfig,
   ApolloDriverConfig,
   ApolloDriverConfigFactory,
-} from './apollo-driver-config.interface';
+} from './apollo-driver-config.interface.js';
 
 export type ApolloFederationDriverConfig = ApolloDriverConfig;
 export type ApolloFederationDriverConfigFactory = ApolloDriverConfigFactory;

packages/apollo/lib/interfaces/apollo-gateway-driver-config.interface.ts

@@ -6,7 +6,7 @@ import {
   GraphQLDriver,
 } from '@nestjs/graphql';
 import { GraphQLSchema } from 'graphql';
-import { ApolloDriverConfig } from './apollo-driver-config.interface';
+import { ApolloDriverConfig } from './apollo-driver-config.interface.js';
 
 /**
  *  @publicApi

packages/apollo/lib/interfaces/index.ts

@@ -1,3 +1,3 @@
-export * from './apollo-driver-config.interface';
-export * from './apollo-federation-driver-config.interface';
-export * from './apollo-gateway-driver-config.interface';
+export * from './apollo-driver-config.interface.js';
+export * from './apollo-federation-driver-config.interface.js';
+export * from './apollo-gateway-driver-config.interface.js';

packages/apollo/lib/services/index.ts

@@ -1 +1 @@
-export * from './plugins-explorer.service';
+export * from './plugins-explorer.service.js';

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

@@ -1,7 +1,7 @@
-import { InstanceWrapper } from '@nestjs/core/injector/instance-wrapper';
-import { ModulesContainer } from '@nestjs/core/injector/modules-container';
+import { InstanceWrapper } from '@nestjs/core/injector/instance-wrapper.js';
+import { ModulesContainer } from '@nestjs/core/injector/modules-container.js';
 import { BaseExplorerService, GqlModuleOptions } from '@nestjs/graphql';
-import { PLUGIN_METADATA } from '../constants';
+import { PLUGIN_METADATA } from '../constants/index.js';
 
 export class PluginsExplorerService extends BaseExplorerService {
   constructor(private readonly modulesContainer: ModulesContainer) {

packages/apollo/lib/utils/get-apollo-server.ts

@@ -1,7 +1,7 @@
 import { ApolloServer, type BaseContext } from '@apollo/server';
 import { INestApplicationContext } from '@nestjs/common';
 import { GraphQLModule } from '@nestjs/graphql';
-import { ApolloDriver } from '..';
+import { ApolloDriver } from '../index.js';
 
 type GetApolloServer = (
   app: INestApplicationContext,

packages/apollo/lib/utils/index.ts

@@ -1 +1 @@
-export * from './get-apollo-server';
+export * from './get-apollo-server.js';