@nestjs/apollo 14.0.0-next.0 → 14.0.1

package/dist/drivers/apollo-base.driver.d.ts

@@ -15,6 +15,7 @@ export declare abstract class ApolloBaseDriver<T extends Record<string, any> = A
     protected registerFastify(options: T, { preStartHook }?: {
         preStartHook?: () => void;
     }): Promise<void>;
+    private createRequestLifecycleHooksPlugin;
     private createPreserveHttpStatusPlugin;
     private wrapFormatErrorFn;
     private createTransformHttpErrorFn;

package/dist/drivers/apollo-base.driver.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apollo-base.driver.d.ts","sourceRoot":"","sources":["../../lib/drivers/apollo-base.driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAUhE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAKxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAU5D,8BAAsB,gBAAgB,CACpC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,kBAAkB,CAClD,SAAQ,qBAAqB,CAAC,CAAC,CAAC;IAChC,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC;IAElD,IAAI,QAAQ,IAAI,YAAY,CAAC,WAAW,CAAC,CAExC;IAEY,KAAK,CAAC,aAAa,EAAE,CAAC;IAa5B,IAAI;IAIE,mBAAmB,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAwDxD,OAAO,CAAC,0BAA0B;IAgB3B,sBAAsB,CAC3B,WAAW,EAAE,OAAO,EACpB,QAAQ,EAAE,CACR,OAAO,EAAE,GAAG,EACZ,SAAS,EAAE,GAAG,EACd,OAAO,EAAE,GAAG,KACT,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EAC/B,sBAAsB,EAAE,QAAQ,IAExB,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAC3C,GAAG,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,KAC/C,GAAG;cAMQ,eAAe,CAC7B,OAAO,EAAE,CAAC,EACV,EAAE,YAAY,EAAE,GAAE;QAAE,YAAY,CAAC,EAAE,MAAM,IAAI,CAAA;KAAO;cAmDtC,eAAe,CAC7B,OAAO,EAAE,CAAC,EACV,EAAE,YAAY,EAAE,GAAE;QAAE,YAAY,CAAC,EAAE,MAAM,IAAI,CAAA;KAAO;IAsCtD,OAAO,CAAC,8BAA8B;IA4BtC,OAAO,CAAC,iBAAiB;IAuBzB,OAAO,CAAC,0BAA0B;IA0ClC,OAAO,CAAC,mBAAmB;IA8B3B,OAAO,CAAC,iBAAiB;CAgB1B"}
+{"version":3,"file":"apollo-base.driver.d.ts","sourceRoot":"","sources":["../../lib/drivers/apollo-base.driver.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,KAAK,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAUhE,OAAO,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAKxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAU5D,8BAAsB,gBAAgB,CACpC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,kBAAkB,CAClD,SAAQ,qBAAqB,CAAC,CAAC,CAAC;IAChC,SAAS,CAAC,YAAY,EAAE,YAAY,CAAC,WAAW,CAAC,CAAC;IAElD,IAAI,QAAQ,IAAI,YAAY,CAAC,WAAW,CAAC,CAExC;IAEY,KAAK,CAAC,aAAa,EAAE,CAAC;IAa5B,IAAI;IAIE,mBAAmB,CAAC,OAAO,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAyDxD,OAAO,CAAC,0BAA0B;IAkB3B,sBAAsB,CAC3B,WAAW,EAAE,OAAO,EACpB,QAAQ,EAAE,CACR,OAAO,EAAE,GAAG,EACZ,SAAS,EAAE,GAAG,EACd,OAAO,EAAE,GAAG,KACT,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,EAC/B,sBAAsB,EAAE,QAAQ,IAExB,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAC3C,GAAG,MAAM,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,KAC/C,GAAG;cAMQ,eAAe,CAC7B,OAAO,EAAE,CAAC,EACV,EAAE,YAAY,EAAE,GAAE;QAAE,YAAY,CAAC,EAAE,MAAM,IAAI,CAAA;KAAO;cAmDtC,eAAe,CAC7B,OAAO,EAAE,CAAC,EACV,EAAE,YAAY,EAAE,GAAE;QAAE,YAAY,CAAC,EAAE,MAAM,IAAI,CAAA;KAAO;IAwCtD,OAAO,CAAC,iCAAiC;IAyCzC,OAAO,CAAC,8BAA8B;IA4BtC,OAAO,CAAC,iBAAiB;IAuBzB,OAAO,CAAC,0BAA0B;IA0ClC,OAAO,CAAC,mBAAmB;IA8B3B,OAAO,CAAC,iBAAiB;CAgB1B"}

package/dist/drivers/apollo-base.driver.js

@@ -42,22 +42,20 @@ export class ApolloBaseDriver extends AbstractGraphQLDriver {
             fieldResolverEnhancers: [],
             stopOnTerminationSignals: false,
         };
-        const useGraphiQL = options.graphiql ||
-            options.playground === true ||
-            (options.graphiql === undefined &&
-                options.playground === undefined &&
-                process.env.NODE_ENV !== 'production');
+        // `graphiql` wins over the deprecated `playground` alias; when neither is
+        // set, GraphiQL is enabled outside of production.
+        const useGraphiQL = options.graphiql ??
+            options.playground ??
+            process.env.NODE_ENV !== 'production';
         if (useGraphiQL) {
-            const graphiQlPlaygroundOpts = typeof options.graphiql === 'object' ? options.graphiql : {};
+            const graphiQlPlaygroundOpts = typeof useGraphiQL === 'object' ? { ...useGraphiQL } : {};
             graphiQlPlaygroundOpts.url ??= options.path;
             defaults = {
                 ...defaults,
                 plugins: [new GraphiQLPlaygroundPlugin(graphiQlPlaygroundOpts)],
             };
         }
-        else if ((options.playground === undefined &&
-            process.env.NODE_ENV === 'production') ||
-            options.playground === false) {
+        else {
             defaults = {
                 ...defaults,
                 plugins: [ApolloServerPluginLandingPageDisabled()],
@@ -68,12 +66,16 @@ export class ApolloBaseDriver extends AbstractGraphQLDriver {
         this.normalizeSubscriptionsPath(options);
         this.wrapContextResolver(options);
         this.wrapFormatErrorFn(options);
-        if (options.autoTransformHttpErrors !== false) {
+        if (options.preserveHttpStatusForExecutionErrors !== false) {
             options.plugins = [
                 ...(options.plugins || []),
                 this.createPreserveHttpStatusPlugin(),
             ];
         }
+        options.plugins = [
+            ...(options.plugins || []),
+            this.createRequestLifecycleHooksPlugin(),
+        ];
         return options;
     }
     normalizeSubscriptionsPath(options) {
@@ -81,21 +83,23 @@ export class ApolloBaseDriver extends AbstractGraphQLDriver {
         if (!subscriptions) {
             return;
         }
-        for (const protocol of [
-            'graphql-ws',
-            'subscriptions-transport-ws',
-        ]) {
-            const config = subscriptions[protocol];
-            if (config && typeof config === 'object' && config.path) {
-                config.path = this.applyGlobalPrefix(config.path, options);
-            }
+        // Rewrite a copy: the caller's configuration object may be reused across
+        // applications, and prefixing it in place compounds on every merge.
+        const normalized = { ...subscriptions };
+        const config = normalized['graphql-ws'];
+        if (config && typeof config === 'object' && config.path) {
+            normalized['graphql-ws'] = {
+                ...config,
+                path: this.applyGlobalPrefix(config.path, options),
+            };
         }
+        options.subscriptions = normalized;
     }
     subscriptionWithFilter(instanceRef, filterFn, createSubscribeContext) {
         return (...args) => createAsyncIterator(createSubscribeContext()(...args), (payload) => filterFn.call(instanceRef, payload, args[1], args[2]));
     }
     async registerExpress(options, { preStartHook } = {}) {
-        const { expressMiddleware } = await loadPackage('@as-integrations/express5', 'GraphQLModule', () => require('@as-integrations/express5'));
+        const { expressMiddleware } = await loadPackage('@as-integrations/express5', 'GraphQLModule', () => import('@as-integrations/express5'));
         const { path, typeDefs, resolvers, schema } = options;
         const httpAdapter = this.httpAdapterHost.httpAdapter;
         // Workaround: the landing page requires body to be present
@@ -128,7 +132,7 @@ export class ApolloBaseDriver extends AbstractGraphQLDriver {
         this.apolloServer = server;
     }
     async registerFastify(options, { preStartHook } = {}) {
-        const { fastifyApolloDrainPlugin, fastifyApolloHandler } = await loadPackage('@as-integrations/fastify', 'GraphQLModule', () => require('@as-integrations/fastify'));
+        const { fastifyApolloDrainPlugin, fastifyApolloHandler } = await loadPackage('@as-integrations/fastify', 'GraphQLModule', () => import('@as-integrations/fastify'));
         const httpAdapter = this.httpAdapterHost.httpAdapter;
         const app = httpAdapter.getInstance();
         const { path, typeDefs, resolvers, schema } = options;
@@ -153,6 +157,40 @@ export class ApolloBaseDriver extends AbstractGraphQLDriver {
         });
         this.apolloServer = server;
     }
+    createRequestLifecycleHooksPlugin() {
+        // Exposes the "request start"/"request end" hooks registered through the
+        // `ResolverDecoratorHost` so that consumers can instrument (and measure)
+        // the entire lifecycle of a single GraphQL operation.
+        const resolverDecoratorHost = () => this.resolverDecoratorHost;
+        return {
+            async requestDidStart(requestContext) {
+                const host = resolverDecoratorHost();
+                if (!host?.hasRequestHooks()) {
+                    return;
+                }
+                const hookContext = {
+                    query: requestContext.request?.query,
+                    operationName: requestContext.request?.operationName,
+                    variables: requestContext.request?.variables,
+                    context: requestContext.contextValue,
+                };
+                const state = host.onRequestStart(hookContext);
+                return {
+                    async willSendResponse(endRequestContext) {
+                        const body = endRequestContext.response?.body;
+                        const errors = endRequestContext.errors ??
+                            (body?.kind === 'single' ? body.singleResult?.errors : undefined);
+                        host.onRequestEnd({
+                            ...hookContext,
+                            operationName: endRequestContext.operationName ?? hookContext.operationName,
+                            errors,
+                            state,
+                        });
+                    },
+                };
+            },
+        };
+    }
     createPreserveHttpStatusPlugin() {
         // When a resolver throws an error whose `extensions.http.status` is set
         // (either directly via GraphQLError or transitively via NestJS HTTP

package/dist/drivers/apollo-federation.driver.js

@@ -17,7 +17,7 @@ let ApolloFederationDriver = class ApolloFederationDriver extends ApolloBaseDriv
     async start(options) {
         options.plugins = extend(options.plugins || [], this.pluginsExplorerService.explore(options));
         if (options.definitions && options.definitions.path) {
-            const { printSubgraphSchema } = await loadPackage('@apollo/subgraph', 'ApolloFederation', () => require('@apollo/subgraph'));
+            const { printSubgraphSchema } = await loadPackage('@apollo/subgraph', 'ApolloFederation', () => import('@apollo/subgraph'));
             await this.graphQlFactory.generateDefinitions(printSubgraphSchema(options.schema), options);
         }
         await super.start(options);

package/dist/drivers/apollo-gateway.driver.js

@@ -16,7 +16,7 @@ let ApolloGatewayDriver = class ApolloGatewayDriver extends ApolloBaseDriver {
     async start(options) {
         options.server ??= {};
         options.server.plugins = extend(options.server.plugins || [], this.pluginsExplorerService.explore(options));
-        const { ApolloGateway } = await loadPackage('@apollo/gateway', 'ApolloGateway', () => require('@apollo/gateway'));
+        const { ApolloGateway } = await loadPackage('@apollo/gateway', 'ApolloGateway', () => import('@apollo/gateway'));
         const { server: serverOpts = {}, gateway: gatewayOpts = {}, transformSchema, } = options;
         const gateway = new ApolloGateway(gatewayOpts);
         await super.start({

package/dist/interfaces/apollo-driver-config.interface.d.ts

@@ -38,6 +38,20 @@ export interface ApolloDriverConfig extends Omit<ApolloServerOptionsWithTypeDefs
      * @default true
      */
     autoTransformHttpErrors?: boolean;
+    /**
+     * Controls whether the Apollo Server plugin that preserves HTTP status codes
+     * for execution errors is injected. When enabled, execution errors (errors that
+     * occur during resolver execution) will have their HTTP status reset to 200,
+     * ensuring the response maintains a stable {data, errors} shape. When disabled,
+     * HTTP status codes from extensions.http.status will be preserved in the response.
+     *
+     * This flag is independent of autoTransformHttpErrors and provides granular
+     * control over HTTP status handling for high-throughput APIs that need to
+     * distinguish between execution errors and request-level errors.
+     * @default true
+     * @see https://github.com/nestjs/graphql/issues/3997
+     */
+    preserveHttpStatusForExecutionErrors?: boolean;
 }
 export type ApolloDriverConfigFactory = GqlOptionsFactory<ApolloDriverConfig>;
 export type ApolloDriverAsyncConfig = GqlModuleAsyncOptions<ApolloDriverConfig>;

package/dist/interfaces/apollo-driver-config.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"apollo-driver-config.interface.d.ts","sourceRoot":"","sources":["../../lib/interfaces/apollo-driver-config.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,sDAAsD,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBACf,SAAQ,IAAI,CACR,+BAA+B,CAAC,GAAG,CAAC,EACpC,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAChD,EACD,kBAAkB,EAClB,gBAAgB;IAClB;;OAEG;IACH,2BAA2B,CAAC,EAAE,OAAO,CAAC;IAEtC;;OAEG;IACH,aAAa,CAAC,EAAE,kBAAkB,CAAC;IAEnC;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,eAAe,CAAC;IAErC;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,MAAM,yBAAyB,GAAG,iBAAiB,CAAC,kBAAkB,CAAC,CAAC;AAC9E,MAAM,MAAM,uBAAuB,GAAG,qBAAqB,CAAC,kBAAkB,CAAC,CAAC"}
+{"version":3,"file":"apollo-driver-config.interface.d.ts","sourceRoot":"","sources":["../../lib/interfaces/apollo-driver-config.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,+BAA+B,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EACL,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EACnB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,sDAAsD,CAAC;AAEvF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED;;GAEG;AACH,MAAM,WAAW,kBACf,SAAQ,IAAI,CACR,+BAA+B,CAAC,GAAG,CAAC,EACpC,UAAU,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAChD,EACD,kBAAkB,EAClB,gBAAgB;IAClB;;OAEG;IACH,2BAA2B,CAAC,EAAE,OAAO,CAAC;IAEtC;;OAEG;IACH,aAAa,CAAC,EAAE,kBAAkB,CAAC;IAEnC;;;OAGG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,GAAG,eAAe,CAAC;IAErC;;;;OAIG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAElC;;;;;;;;;;;;OAYG;IACH,oCAAoC,CAAC,EAAE,OAAO,CAAC;CAChD;AAED,MAAM,MAAM,yBAAyB,GAAG,iBAAiB,CAAC,kBAAkB,CAAC,CAAC;AAC9E,MAAM,MAAM,uBAAuB,GAAG,qBAAqB,CAAC,kBAAkB,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs/apollo",
-  "version": "14.0.0-next.0",
+  "version": "14.0.1",
   "description": "Nest - modern, fast, powerful node.js web framework (@apollo)",
   "author": "Kamil Mysliwiec",
   "license": "MIT",
@@ -32,17 +32,17 @@
     "url": "https://github.com/nestjs/graphql/issues"
   },
   "devDependencies": {
-    "@apollo/gateway": "2.10.5",
-    "@apollo/server": "5.5.0",
+    "@apollo/gateway": "2.14.4",
+    "@apollo/server": "5.5.1",
     "@apollo/server-plugin-response-cache": "5.0.0",
-    "@apollo/subgraph": "2.11.2",
+    "@apollo/subgraph": "2.14.4",
     "@as-integrations/express5": "^1.1.2",
     "@as-integrations/fastify": "3.1.0",
-    "@nestjs/common": "next",
-    "@nestjs/core": "next",
-    "@nestjs/platform-express": "next",
-    "@nestjs/platform-fastify": "next",
-    "@nestjs/testing": "next",
+    "@nestjs/common": "12.0.3",
+    "@nestjs/core": "12.0.3",
+    "@nestjs/platform-express": "12.0.3",
+    "@nestjs/platform-fastify": "12.0.3",
+    "@nestjs/testing": "12.0.3",
     "apollo-cache-inmemory": "1.6.6",
     "apollo-client": "2.6.10"
   },
@@ -56,10 +56,10 @@
     "@apollo/server": "^5.0.0",
     "@apollo/subgraph": "^2.0.0",
     "@as-integrations/fastify": "^2.1.1 || ^3.0.0",
-    "@nestjs/common": "next",
-    "@nestjs/core": "next",
-    "@nestjs/graphql": "^13.0.0",
-    "graphql": "^16.10.0"
+    "@nestjs/common": "^12.0.0",
+    "@nestjs/core": "^12.0.0",
+    "@nestjs/graphql": "^14.0.0",
+    "graphql": "^16.10.0 || ^17.0.0"
   },
   "peerDependenciesMeta": {
     "@apollo/gateway": {
@@ -75,5 +75,5 @@
       "optional": true
     }
   },
-  "gitHead": "03340407bdb10001df14288ec3a4aa026f2f2924"
+  "gitHead": "2f093da088290b936631d7e0a68b368222c2a9f0"
 }