@fluojs/graphql 1.1.0 → 2.0.0

package/dist/service.d.ts

@@ -1,5 +1,5 @@
 import type { Container } from '@fluojs/di';
-import { type HttpApplicationAdapter } from '@fluojs/http';
+import { type HttpApplicationAdapter, type Middleware, type MiddlewareContext, type Next } from '@fluojs/http';
 import type { ApplicationLogger, CompiledModule, OnApplicationBootstrap, OnApplicationShutdown } from '@fluojs/runtime';
 import type { GraphqlModuleOptions } from './types.js';
 /**
@@ -12,23 +12,26 @@ export declare class GraphqlEndpointController {
 /**
  * Boots the GraphQL runtime, middleware, and subscription transports for the active adapter.
  */
-export declare class GraphqlLifecycleService implements OnApplicationBootstrap, OnApplicationShutdown {
+export declare class GraphqlLifecycleService implements Middleware, OnApplicationBootstrap, OnApplicationShutdown {
     private readonly runtimeContainer;
     private readonly compiledModules;
     private readonly logger;
     private readonly adapter;
     private readonly options;
+    private allowedCrossRealmGraphqlObjects;
     private graphQLErrorConstructor;
-    private middlewareRegistered;
     private readonly operationContainers;
     private readonly requestContexts;
+    private readonly failedWebsocketOperationContainers;
+    private readonly websocketContainerDisposals;
+    private websocketContainersAttemptedInCurrentCleanup;
     private readonly websocketOperationContainers;
     private websocketTransport;
     private executeGraphqlOperation;
     private releaseGraphqlInstanceOfPatch;
     private subscribeGraphqlOperation;
     private yoga;
-    private readonly middleware;
+    handle(context: MiddlewareContext, next: Next): Promise<void>;
     constructor(runtimeContainer: Container, compiledModules: readonly CompiledModule[], logger: ApplicationLogger, adapter: HttpApplicationAdapter, options: GraphqlModuleOptions);
     onApplicationBootstrap(): Promise<void>;
     onApplicationShutdown(): Promise<void>;
@@ -39,8 +42,6 @@ export declare class GraphqlLifecycleService implements OnApplicationBootstrap,
     private resolveSchema;
     private createCodeFirstSchema;
     private discoverResolverDescriptors;
-    private registerMiddleware;
-    private unregisterMiddleware;
     private buildGraphqlContext;
     private registerWebSocketTransport;
     private unregisterWebSocketTransport;
@@ -49,8 +50,10 @@ export declare class GraphqlLifecycleService implements OnApplicationBootstrap,
     private createWebSocketOperationLimitError;
     private getOrCreateWebSocketOperationContainer;
     private disposeWebSocketOperationContainer;
+    private disposeWebSocketContainerOnce;
     private disposeAllWebSocketOperationContainers;
     private getOrCreateOperationContainer;
     private disposeOperationContainer;
+    private disposeAllOperationContainers;
 }
 //# sourceMappingURL=service.d.ts.map

package/dist/service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAA0C,KAAK,sBAAsB,EAA4D,MAAM,cAAc,CAAC;AAC7J,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AA0BxH,OAAO,KAAK,EAEV,oBAAoB,EAGrB,MAAM,YAAY,CAAC;AA2EpB;;GAEG;AACH,qBACa,yBAAyB;IAEpC,SAAS,IAAI,SAAS;IAKtB,UAAU,IAAI,SAAS;CAGxB;AA4JD;;GAEG;AACH,qBACa,uBAAwB,YAAW,sBAAsB,EAAE,qBAAqB;IA0DzF,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IA7D1B,OAAO,CAAC,uBAAuB,CAAsC;IACrE,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAqC;IACzE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiD;IACjF,OAAO,CAAC,QAAQ,CAAC,4BAA4B,CAA6C;IAC1F,OAAO,CAAC,kBAAkB,CAA4C;IACtE,OAAO,CAAC,uBAAuB,CAAoC;IACnE,OAAO,CAAC,6BAA6B,CAA2B;IAChE,OAAO,CAAC,yBAAyB,CAAsC;IACvE,OAAO,CAAC,IAAI,CAAuB;IAEnC,OAAO,CAAC,QAAQ,CAAC,UAAU,CA2CzB;gBAGiB,gBAAgB,EAAE,SAAS,EAC3B,eAAe,EAAE,SAAS,cAAc,EAAE,EAC1C,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,sBAAsB,EAC/B,OAAO,EAAE,oBAAoB;IAG1C,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IAgDvC,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;YAI9B,wBAAwB;IAYtC,OAAO,CAAC,sBAAsB;IAI9B,OAAO,CAAC,2BAA2B;IAInC,OAAO,CAAC,sBAAsB;IAe9B,OAAO,CAAC,aAAa;IAMrB,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,2BAA2B;IAInC,OAAO,CAAC,kBAAkB;IAiB1B,OAAO,CAAC,oBAAoB;IAmB5B,OAAO,CAAC,mBAAmB;YAyBb,0BAA0B;YAgC1B,4BAA4B;IAgB1C,OAAO,CAAC,2BAA2B;YAIrB,wBAAwB;IAmDtC,OAAO,CAAC,kCAAkC;IAwB1C,OAAO,CAAC,sCAAsC;YAchC,kCAAkC;YAqBlC,sCAAsC;IAkBpD,OAAO,CAAC,6BAA6B;YAYvB,yBAAyB;CAexC"}
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../src/service.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAA0C,KAAK,sBAAsB,EAAE,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,KAAK,IAAI,EAAQ,MAAM,cAAc,CAAC;AAC7J,OAAO,KAAK,EAAE,iBAAiB,EAAE,cAAc,EAAE,sBAAsB,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AA2BxH,OAAO,KAAK,EAEV,oBAAoB,EAGrB,MAAM,YAAY,CAAC;AAkFpB;;GAEG;AACH,qBACa,yBAAyB;IAEpC,SAAS,IAAI,SAAS;IAKtB,UAAU,IAAI,SAAS;CAGxB;AA0ED;;GAEG;AACH,qBACa,uBAAwB,YAAW,UAAU,EAAE,sBAAsB,EAAE,qBAAqB;IA2DrG,OAAO,CAAC,QAAQ,CAAC,gBAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,eAAe;IAChC,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IA9D1B,OAAO,CAAC,+BAA+B,CAA8B;IACrE,OAAO,CAAC,uBAAuB,CAAsC;IACrE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAiC;IACrE,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAiD;IACjF,OAAO,CAAC,QAAQ,CAAC,kCAAkC,CAAqC;IACxF,OAAO,CAAC,QAAQ,CAAC,2BAA2B,CAA0C;IACtF,OAAO,CAAC,4CAA4C,CAA6B;IACjF,OAAO,CAAC,QAAQ,CAAC,4BAA4B,CAA6C;IAC1F,OAAO,CAAC,kBAAkB,CAA4C;IACtE,OAAO,CAAC,uBAAuB,CAAoC;IACnE,OAAO,CAAC,6BAA6B,CAA2B;IAChE,OAAO,CAAC,yBAAyB,CAAsC;IACvE,OAAO,CAAC,IAAI,CAAuB;IAE7B,MAAM,CAAC,OAAO,EAAE,iBAAiB,EAAE,IAAI,EAAE,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;gBA4ChD,gBAAgB,EAAE,SAAS,EAC3B,eAAe,EAAE,SAAS,cAAc,EAAE,EAC1C,MAAM,EAAE,iBAAiB,EACzB,OAAO,EAAE,sBAAsB,EAC/B,OAAO,EAAE,oBAAoB;IAG1C,sBAAsB,IAAI,OAAO,CAAC,IAAI,CAAC;IA6CvC,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;YAI9B,wBAAwB;IA+BtC,OAAO,CAAC,sBAAsB;IAI9B,OAAO,CAAC,2BAA2B;IAInC,OAAO,CAAC,sBAAsB;IAe9B,OAAO,CAAC,aAAa;IASrB,OAAO,CAAC,qBAAqB;IAI7B,OAAO,CAAC,2BAA2B;IAInC,OAAO,CAAC,mBAAmB;YAyBb,0BAA0B;YAkC1B,4BAA4B;IAiC1C,OAAO,CAAC,2BAA2B;YAIrB,wBAAwB;IAmDtC,OAAO,CAAC,kCAAkC;IAwB1C,OAAO,CAAC,sCAAsC;YAchC,kCAAkC;YAiBlC,6BAA6B;YAuC7B,sCAAsC;IA+BpD,OAAO,CAAC,6BAA6B;YAYvB,yBAAyB;YAiBzB,6BAA6B;CAe5C"}

package/dist/service.js

@@ -4,21 +4,36 @@ function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol"
 function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
 function _setFunctionName(e, t, n) { "symbol" == typeof t && (t = (t = t.description) ? "[" + t + "]" : ""); try { Object.defineProperty(e, "name", { configurable: !0, value: n ? n + " " + t : t }); } catch (e) {} return e; }
 function _checkInRHS(e) { if (Object(e) !== e) throw TypeError("right-hand side of 'in' should be an object, got " + (null !== e ? typeof e : "null")); return e; }
+import { createRequire } from 'node:module';
 import { Inject } from '@fluojs/core';
 import { Controller, Get, Post } from '@fluojs/http';
 import { APPLICATION_LOGGER, COMPILED_MODULES, HTTP_APPLICATION_ADAPTER, RUNTIME_CONTAINER } from '@fluojs/runtime/internal';
 import { discoverResolverDescriptors } from './discovery.js';
 import { createGraphqlValidationPlugin, resolveGraphqlRequestLimits } from './guardrails.js';
+import { installGraphqlInstanceOfPatch } from './instance-of-patch.js';
 import { GRAPHQL_INTERNAL_MODULE_OPTIONS_TOKEN } from './internal-tokens.js';
 import { createCodeFirstSchema, resolveSchema } from './schema/schema.js';
 import { isGraphqlPath, toFetchRequest, writeFetchResponse } from './transport/transport.js';
 import { GRAPHQL_OPERATION_CONTAINER } from './types.js';
 const GRAPHQL_CONTEXT_OVERRIDE = Symbol('fluo.graphql.context.override');
+const runtimeRequire = createRequire(import.meta.url);
 const DEFAULT_GRAPHQL_WEBSOCKET_LIMITS = {
   maxConnections: 100,
   maxOperationsPerConnection: 25,
   maxPayloadBytes: 64 * 1024
 };
+function collectCleanupError(errors, error) {
+  if (error instanceof AggregateError) {
+    for (const nested of error.errors) {
+      collectCleanupError(errors, nested);
+    }
+    return;
+  }
+  if (errors.includes(error)) {
+    return;
+  }
+  errors.push(error);
+}
 function buildFrameworkRequestFromFetchRequest(request) {
   const requestUrl = new URL(request.url);
   return {
@@ -33,14 +48,10 @@ function buildFrameworkRequestFromFetchRequest(request) {
     url: requestUrl.pathname + requestUrl.search
   };
 }
-let graphqlInstanceOfPatchRefCount = 0;
-let restoreGraphqlInstanceOfPatch;
-const allowedCrossRealmGraphqlObjects = new WeakSet();
-
+let _GraphqlEndpointContr;
 /**
  * Declares the HTTP endpoints that receive GraphQL GET and POST requests.
  */
-let _GraphqlEndpointContr;
 class GraphqlEndpointController {
   static {
     ({
@@ -62,23 +73,7 @@ class GraphqlEndpointController {
   }
 }
 export { _GraphqlEndpointContr as GraphqlEndpointController };
-function getCrossRealmGraphqlTag(value, constructor) {
-  const prototypeTag = constructor.prototype?.[Symbol.toStringTag];
-  const className = typeof prototypeTag === 'string' ? prototypeTag : constructor.name;
-  if (typeof className !== 'string' || !className.startsWith('GraphQL')) {
-    return undefined;
-  }
-  if (typeof value !== 'object' || value === null) {
-    return undefined;
-  }
-  const valueTag = value[Symbol.toStringTag];
-  if (typeof valueTag === 'string') {
-    return valueTag === className ? className : undefined;
-  }
-  const valueClassName = value.constructor?.name;
-  return valueClassName === className ? className : undefined;
-}
-function markAllowedCrossRealmGraphqlObjects(value, visited = new WeakSet()) {
+function markAllowedCrossRealmGraphqlObjects(value, allowedObjects, visited = new WeakSet()) {
   if (typeof value !== 'object' || value === null) {
     return;
   }
@@ -89,69 +84,24 @@ function markAllowedCrossRealmGraphqlObjects(value, visited = new WeakSet()) {
   const tag = value[Symbol.toStringTag];
   const constructorName = value.constructor?.name;
   if (typeof tag === 'string' && tag.startsWith('GraphQL') || typeof constructorName === 'string' && constructorName.startsWith('GraphQL')) {
-    allowedCrossRealmGraphqlObjects.add(value);
+    allowedObjects.add(value);
   }
   if (Array.isArray(value)) {
     for (const item of value) {
-      markAllowedCrossRealmGraphqlObjects(item, visited);
+      markAllowedCrossRealmGraphqlObjects(item, allowedObjects, visited);
     }
     return;
   }
   for (const nestedValue of Object.values(value)) {
-    markAllowedCrossRealmGraphqlObjects(nestedValue, visited);
+    markAllowedCrossRealmGraphqlObjects(nestedValue, allowedObjects, visited);
   }
 }
-function isAllowedCrossRealmGraphqlObject(value, constructor) {
-  if (typeof value !== 'object' || value === null) {
-    return false;
-  }
-  return allowedCrossRealmGraphqlObjects.has(value) && getCrossRealmGraphqlTag(value, constructor) !== undefined;
-}
-function installGraphqlInstanceOfPatch(instanceOfModule) {
-  if (restoreGraphqlInstanceOfPatch) {
-    graphqlInstanceOfPatchRefCount += 1;
-    return releaseGraphqlInstanceOfPatch;
-  }
-  const patchedFrom = instanceOfModule.instanceOf;
-  const patchedInstanceOf = (value, constructor) => {
-    try {
-      if (patchedFrom(value, constructor)) {
-        return true;
-      }
-    } catch (error) {
-      if (isAllowedCrossRealmGraphqlObject(value, constructor)) {
-        return true;
-      }
-      throw error;
-    }
-    return isAllowedCrossRealmGraphqlObject(value, constructor);
-  };
-  instanceOfModule.instanceOf = patchedInstanceOf;
-  graphqlInstanceOfPatchRefCount = 1;
-  restoreGraphqlInstanceOfPatch = () => {
-    if (instanceOfModule.instanceOf !== patchedInstanceOf) {
-      return;
-    }
-    instanceOfModule.instanceOf = patchedFrom;
-  };
-  return releaseGraphqlInstanceOfPatch;
-}
-function releaseGraphqlInstanceOfPatch() {
-  if (graphqlInstanceOfPatchRefCount === 0) {
-    return;
-  }
-  graphqlInstanceOfPatchRefCount -= 1;
-  if (graphqlInstanceOfPatchRefCount > 0) {
-    return;
-  }
-  restoreGraphqlInstanceOfPatch?.();
-  restoreGraphqlInstanceOfPatch = undefined;
-}
 async function loadGraphqlDeps() {
   const graphqlSpecifier = 'graphql';
   const yogaSpecifier = 'graphql-yoga';
   const instanceOfSpecifier = 'graphql/jsutils/instanceOf.js';
-  const [graphqlMod, yogaMod, instanceOfModule] = await Promise.all([import(/* @vite-ignore */graphqlSpecifier), import(/* @vite-ignore */yogaSpecifier), import(/* @vite-ignore */instanceOfSpecifier)]);
+  const [graphqlMod, yogaMod] = await Promise.all([import(/* @vite-ignore */graphqlSpecifier), import(/* @vite-ignore */yogaSpecifier)]);
+  const instanceOfModule = runtimeRequire(instanceOfSpecifier);
   return {
     GraphQLError: graphqlMod.GraphQLError,
     GraphQLBoolean: graphqlMod.GraphQLBoolean,
@@ -181,59 +131,60 @@ class GraphqlLifecycleService {
   static {
     [_GraphqlLifecycleServ, _initClass2] = _applyDecs(this, [Inject(RUNTIME_CONTAINER, COMPILED_MODULES, APPLICATION_LOGGER, HTTP_APPLICATION_ADAPTER, GRAPHQL_INTERNAL_MODULE_OPTIONS_TOKEN)], []).c;
   }
+  allowedCrossRealmGraphqlObjects;
   graphQLErrorConstructor;
-  middlewareRegistered = false;
-  operationContainers = new WeakMap();
+  operationContainers = new Map();
   requestContexts = new WeakMap();
+  failedWebsocketOperationContainers = new Map();
+  websocketContainerDisposals = new Map();
+  websocketContainersAttemptedInCurrentCleanup;
   websocketOperationContainers = new Map();
   websocketTransport;
   executeGraphqlOperation;
   releaseGraphqlInstanceOfPatch;
   subscribeGraphqlOperation;
   yoga;
-  middleware = {
-    handle: async (context, next) => {
-      if (!isGraphqlPath(context.request.path)) {
-        await next();
-        return;
+  async handle(context, next) {
+    if (!isGraphqlPath(context.request.path)) {
+      await next();
+      return;
+    }
+    const yoga = this.yoga;
+    if (!yoga) {
+      this.logger.error('GraphQL middleware was invoked before GraphQL Yoga initialization.', undefined, 'GraphqlLifecycleService');
+      context.response.setStatus(500);
+      await context.response.send({
+        errors: [{
+          message: 'GraphQL server not initialized.'
+        }]
+      });
+      return;
+    }
+    try {
+      const fetchRequest = toFetchRequest(context.request);
+      this.requestContexts.set(fetchRequest, {
+        principal: context.requestContext.principal,
+        request: context.request
+      });
+      try {
+        const fetchResponse = await yoga.fetch(fetchRequest);
+        await writeFetchResponse(fetchResponse, context.response);
+      } finally {
+        this.requestContexts.delete(fetchRequest);
+        await this.disposeOperationContainer(fetchRequest);
       }
-      const yoga = this.yoga;
-      if (!yoga) {
-        this.logger.error('GraphQL middleware was invoked before GraphQL Yoga initialization.', undefined, 'GraphqlLifecycleService');
+    } catch (error) {
+      this.logger.error('Failed to process GraphQL request.', error, 'GraphqlLifecycleService');
+      if (!context.response.committed) {
         context.response.setStatus(500);
         await context.response.send({
           errors: [{
-            message: 'GraphQL server not initialized.'
+            message: 'Internal server error.'
           }]
         });
-        return;
-      }
-      try {
-        const fetchRequest = toFetchRequest(context.request);
-        this.requestContexts.set(fetchRequest, {
-          principal: context.requestContext.principal,
-          request: context.request
-        });
-        try {
-          const fetchResponse = await yoga.fetch(fetchRequest);
-          await writeFetchResponse(fetchResponse, context.response);
-        } finally {
-          this.requestContexts.delete(fetchRequest);
-          await this.disposeOperationContainer(fetchRequest);
-        }
-      } catch (error) {
-        this.logger.error('Failed to process GraphQL request.', error, 'GraphqlLifecycleService');
-        if (!context.response.committed) {
-          context.response.setStatus(500);
-          await context.response.send({
-            errors: [{
-              message: 'Internal server error.'
-            }]
-          });
-        }
       }
     }
-  };
+  }
   constructor(runtimeContainer, compiledModules, logger, adapter, options) {
     this.runtimeContainer = runtimeContainer;
     this.compiledModules = compiledModules;
@@ -242,7 +193,7 @@ class GraphqlLifecycleService {
     this.options = options;
   }
   async onApplicationBootstrap() {
-    if (this.middlewareRegistered) {
+    if (this.yoga) {
       return;
     }
     try {
@@ -266,8 +217,6 @@ class GraphqlLifecycleService {
         schema
       });
       await this.registerWebSocketTransport();
-      this.registerMiddleware();
-      this.middlewareRegistered = true;
     } catch (error) {
       try {
         await this.resetGraphqlRuntimeState();
@@ -281,13 +230,28 @@ class GraphqlLifecycleService {
     await this.resetGraphqlRuntimeState();
   }
   async resetGraphqlRuntimeState() {
-    await this.unregisterWebSocketTransport();
-    this.unregisterMiddleware();
-    this.middlewareRegistered = false;
+    const cleanupErrors = [];
+    this.websocketContainersAttemptedInCurrentCleanup = new Set();
+    try {
+      await this.unregisterWebSocketTransport();
+    } catch (error) {
+      collectCleanupError(cleanupErrors, error);
+    } finally {
+      this.websocketContainersAttemptedInCurrentCleanup = undefined;
+    }
+    try {
+      await this.disposeAllOperationContainers();
+    } catch (error) {
+      collectCleanupError(cleanupErrors, error);
+    }
+    if (cleanupErrors.length > 0) {
+      throw new AggregateError(cleanupErrors, 'Failed to clean up GraphQL runtime resources.');
+    }
     this.executeGraphqlOperation = undefined;
     this.graphQLErrorConstructor = undefined;
     this.releaseGraphqlInstanceOfPatch?.();
     this.releaseGraphqlInstanceOfPatch = undefined;
+    this.allowedCrossRealmGraphqlObjects = undefined;
     this.subscribeGraphqlOperation = undefined;
     this.yoga = undefined;
   }
@@ -309,43 +273,18 @@ class GraphqlLifecycleService {
     };
   }
   resolveSchema(deps) {
-    this.releaseGraphqlInstanceOfPatch ??= installGraphqlInstanceOfPatch(deps.instanceOfModule);
-    return resolveSchema(deps, this.options.schema, () => this.createCodeFirstSchema(deps), markAllowedCrossRealmGraphqlObjects);
+    const allowedObjects = this.allowedCrossRealmGraphqlObjects ?? new WeakSet();
+    this.allowedCrossRealmGraphqlObjects = allowedObjects;
+    this.releaseGraphqlInstanceOfPatch ??= installGraphqlInstanceOfPatch(deps.instanceOfModule, allowedObjects);
+    const markAllowedObject = value => markAllowedCrossRealmGraphqlObjects(value, allowedObjects);
+    return resolveSchema(deps, this.options.schema, () => this.createCodeFirstSchema(deps, markAllowedObject), markAllowedObject);
   }
-  createCodeFirstSchema(deps) {
-    return createCodeFirstSchema(deps, this.runtimeContainer, this.discoverResolverDescriptors(), markAllowedCrossRealmGraphqlObjects);
+  createCodeFirstSchema(deps, markAllowedObject) {
+    return createCodeFirstSchema(deps, this.runtimeContainer, this.discoverResolverDescriptors(), markAllowedObject);
   }
   discoverResolverDescriptors() {
     return discoverResolverDescriptors(this.compiledModules, this.options);
   }
-  registerMiddleware() {
-    for (const compiledModule of this.compiledModules) {
-      if (!compiledModule.providerTokens.has(_GraphqlLifecycleServ)) {
-        continue;
-      }
-      const middleware = compiledModule.definition.middleware ?? [];
-      if (!middleware.includes(this.middleware)) {
-        compiledModule.definition.middleware = [...middleware, this.middleware];
-        continue;
-      }
-      compiledModule.definition.middleware = [...middleware];
-    }
-  }
-  unregisterMiddleware() {
-    for (const compiledModule of this.compiledModules) {
-      if (!compiledModule.providerTokens.has(_GraphqlLifecycleServ)) {
-        continue;
-      }
-      const middleware = compiledModule.definition.middleware ?? [];
-      const remaining = [];
-      for (const entry of middleware) {
-        if (entry !== this.middleware) {
-          remaining.push(entry);
-        }
-      }
-      compiledModule.definition.middleware = remaining;
-    }
-  }
   buildGraphqlContext(request, requestContextOverride, operationContainerOverride) {
     const storedContext = this.requestContexts.get(request);
     const requestContext = {
@@ -383,7 +322,9 @@ class GraphqlLifecycleService {
       },
       keepAliveMs: this.options.subscriptions?.websocket?.keepAliveMs,
       limits: this.resolveWebSocketLimits(),
-      onComplete: (socketKey, operationId) => this.disposeWebSocketOperationContainer(socketKey, operationId),
+      onComplete: async (socketKey, operationId) => {
+        await this.disposeWebSocketOperationContainer(socketKey, operationId);
+      },
       onDisconnect: socketKey => this.disposeAllWebSocketOperationContainers(socketKey),
       onSubscribe: request => this.handleWebSocketSubscribe(request),
       subscribe: args => {
@@ -395,16 +336,28 @@ class GraphqlLifecycleService {
     });
   }
   async unregisterWebSocketTransport() {
+    const cleanupErrors = [];
     if (this.websocketTransport) {
       try {
         await this.websocketTransport.dispose();
       } catch (error) {
         this.logger.error('Failed to dispose GraphQL websocket transport.', error, 'GraphqlLifecycleService');
+        collectCleanupError(cleanupErrors, error);
+      }
+      if (cleanupErrors.length === 0) {
+        this.websocketTransport = undefined;
+      }
+    }
+    const socketKeys = new Set([...this.websocketOperationContainers.keys(), ...this.failedWebsocketOperationContainers.keys()]);
+    for (const socketKey of socketKeys) {
+      try {
+        await this.disposeAllWebSocketOperationContainers(socketKey);
+      } catch (error) {
+        collectCleanupError(cleanupErrors, error);
       }
     }
-    this.websocketTransport = undefined;
-    for (const socketKey of this.websocketOperationContainers.keys()) {
-      await this.disposeAllWebSocketOperationContainers(socketKey);
+    if (cleanupErrors.length > 0) {
+      throw new AggregateError(cleanupErrors, 'Failed to dispose GraphQL websocket resources.');
     }
   }
   isWebSocketTransportEnabled() {
@@ -421,12 +374,12 @@ class GraphqlLifecycleService {
     }
     const fetchRequest = toFetchRequest(request.request);
     const operationContainer = this.getOrCreateWebSocketOperationContainer(request.socket, request.operationId);
-    const graphqlContext = this.buildGraphqlContext(fetchRequest, {
-      connectionParams: request.connectionParams,
-      request: request.request,
-      socket: request.socket
-    }, operationContainer);
     try {
+      const graphqlContext = this.buildGraphqlContext(fetchRequest, {
+        connectionParams: request.connectionParams,
+        request: request.request,
+        socket: request.socket
+      }, operationContainer);
       const {
         contextFactory,
         parse,
@@ -490,25 +443,55 @@ class GraphqlLifecycleService {
     if (socketContainers && socketContainers.size === 0) {
       this.websocketOperationContainers.delete(socketKey);
     }
-    try {
-      await operationContainer.dispose();
-    } catch (error) {
-      this.logger.error('Failed to dispose GraphQL websocket operation container.', error, 'GraphqlLifecycleService');
+    return await this.disposeWebSocketContainerOnce(socketKey, operationContainer);
+  }
+  async disposeWebSocketContainerOnce(socketKey, operationContainer) {
+    const inFlight = this.websocketContainerDisposals.get(operationContainer);
+    if (inFlight) {
+      return await inFlight;
     }
+    const attempted = this.websocketContainersAttemptedInCurrentCleanup;
+    if (attempted?.has(operationContainer)) {
+      return undefined;
+    }
+    attempted?.add(operationContainer);
+    const disposal = operationContainer.dispose().then(() => {
+      this.failedWebsocketOperationContainers.get(socketKey)?.delete(operationContainer);
+      return undefined;
+    }, error => {
+      const failedContainers = this.failedWebsocketOperationContainers.get(socketKey) ?? new Set();
+      failedContainers.add(operationContainer);
+      this.failedWebsocketOperationContainers.set(socketKey, failedContainers);
+      this.logger.error('Failed to dispose GraphQL websocket operation container.', error, 'GraphqlLifecycleService');
+      return error;
+    }).finally(() => {
+      this.websocketContainerDisposals.delete(operationContainer);
+    });
+    this.websocketContainerDisposals.set(operationContainer, disposal);
+    return await disposal;
   }
   async disposeAllWebSocketOperationContainers(socketKey) {
-    const socketContainers = this.websocketOperationContainers.get(socketKey);
-    if (!socketContainers) {
-      return;
+    const cleanupErrors = [];
+    const failedContainers = this.failedWebsocketOperationContainers.get(socketKey);
+    for (const operationContainer of [...(failedContainers ?? [])]) {
+      const cleanupError = await this.disposeWebSocketContainerOnce(socketKey, operationContainer);
+      if (cleanupError !== undefined) {
+        collectCleanupError(cleanupErrors, cleanupError);
+      }
     }
-    this.websocketOperationContainers.delete(socketKey);
-    for (const operationContainer of socketContainers.values()) {
-      try {
-        await operationContainer.dispose();
-      } catch (error) {
-        this.logger.error('Failed to dispose GraphQL websocket operation container.', error, 'GraphqlLifecycleService');
+    if (failedContainers?.size === 0) {
+      this.failedWebsocketOperationContainers.delete(socketKey);
+    }
+    const socketContainers = this.websocketOperationContainers.get(socketKey);
+    for (const operationId of [...(socketContainers?.keys() ?? [])]) {
+      const cleanupError = await this.disposeWebSocketOperationContainer(socketKey, operationId);
+      if (cleanupError !== undefined) {
+        collectCleanupError(cleanupErrors, cleanupError);
       }
     }
+    if (cleanupErrors.length > 0) {
+      throw new AggregateError(cleanupErrors, 'Failed to dispose GraphQL websocket operation containers.');
+    }
   }
   getOrCreateOperationContainer(request) {
     const existing = this.operationContainers.get(request);
@@ -524,11 +507,24 @@ class GraphqlLifecycleService {
     if (!operationContainer) {
       return;
     }
-    this.operationContainers.delete(request);
     try {
       await operationContainer.dispose();
     } catch (error) {
       this.logger.error('Failed to dispose GraphQL operation container.', error, 'GraphqlLifecycleService');
+      return error;
+    }
+    this.operationContainers.delete(request);
+  }
+  async disposeAllOperationContainers() {
+    const cleanupErrors = [];
+    for (const request of [...this.operationContainers.keys()]) {
+      const cleanupError = await this.disposeOperationContainer(request);
+      if (cleanupError !== undefined) {
+        collectCleanupError(cleanupErrors, cleanupError);
+      }
+    }
+    if (cleanupErrors.length > 0) {
+      throw new AggregateError(cleanupErrors, 'Failed to dispose GraphQL operation containers.');
     }
   }
   static {

package/dist/transport/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/transport/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAA2B,MAAM,cAAc,CAAC;AAEjG;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AA6ED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAUjE;AAgGD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,aAAa,EAAE,QAAQ,EAAE,iBAAiB,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BrH"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/transport/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,iBAAiB,EAA2B,MAAM,cAAc,CAAC;AAEjG;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAEnD;AA6ED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAUjE;AAmGD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,aAAa,EAAE,QAAQ,EAAE,iBAAiB,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BrH"}

package/dist/transport/transport.js

@@ -150,7 +150,7 @@ async function writeFetchResponseStream(body, stream) {
       }
     }
   } catch (error) {
-    await cancelUnreadBody();
+    await cancelUnreadBody().then(() => undefined, () => undefined);
     throw error;
   } finally {
     removeCloseListener?.();

package/dist/types.d.ts

@@ -1,4 +1,4 @@
-import type { MetadataPropertyKey, Token } from '@fluojs/core';
+import type { ForwardRefToken, InjectionToken, MaybePromise, MetadataPropertyKey, OptionalInjectToken, Token } from '@fluojs/core';
 import type { Container } from '@fluojs/di';
 import type { FrameworkRequest, Principal } from '@fluojs/http';
 import type { GraphQLObjectType, GraphQLSchema, GraphQLUnionType } from 'graphql';
@@ -105,7 +105,7 @@ export type ResolverHandlerType = 'query' | 'mutation' | 'subscription' | 'field
 /**
  * Explicit source kinds that can be bound to object field-resolver parameters.
  */
-export type FieldResolverParameterKind = 'parent' | 'context';
+export type FieldResolverParameterKind = 'parent' | 'context' | 'input';
 /**
  * Describes one positional parameter binding for an object field resolver.
  */
@@ -233,4 +233,27 @@ export interface GraphqlModuleOptions {
     plugins?: unknown[];
     subscriptions?: GraphqlSubscriptionsOptions;
 }
+type GraphqlAsyncFactoryDependencies<TTokens extends readonly InjectionToken[]> = {
+    -readonly [Index in keyof TTokens]: TTokens[Index] extends OptionalInjectToken<infer TDependency> ? TDependency | undefined : TTokens[Index] extends ForwardRefToken<infer TDependency> ? TDependency : TTokens[Index] extends Token<infer TDependency> ? TDependency : never;
+};
+/**
+ * Configures GraphQL registration through explicitly injected application dependencies.
+ *
+ * Only `inject` and `useFactory` are supported. NestJS-style `imports`, `useClass`,
+ * `useExisting`, and implicit provider discovery are intentionally unavailable.
+ *
+ * @typeParam TTokens Tuple of injection tokens whose resolved values are passed
+ * to `useFactory` in the same order. Optional tokens resolve as `T | undefined`.
+ */
+export interface GraphqlAsyncModuleOptions<TTokens extends readonly InjectionToken[] = readonly InjectionToken[]> {
+    /**
+     * Application-graph tokens whose resolved values are passed to `useFactory` in order.
+     */
+    inject?: TTokens;
+    /**
+     * Resolves the GraphQL module options from the explicitly injected dependency values.
+     */
+    useFactory: (...dependencies: GraphqlAsyncFactoryDependencies<TTokens>) => MaybePromise<GraphqlModuleOptions>;
+}
+export {};
 //# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -137,4 +137,14 @@ export function isGraphqlListTypeRef(value) {
  * @remarks
  * Keep README examples for end-to-end module wiring. Source hover docs here are
  * meant to clarify how each option shapes the per-request execution pipeline.
+ */
+
+/**
+ * Configures GraphQL registration through explicitly injected application dependencies.
+ *
+ * Only `inject` and `useFactory` are supported. NestJS-style `imports`, `useClass`,
+ * `useExisting`, and implicit provider discovery are intentionally unavailable.
+ *
+ * @typeParam TTokens Tuple of injection tokens whose resolved values are passed
+ * to `useFactory` in the same order. Optional tokens resolve as `T | undefined`.
  */