@fluojs/graphql 1.0.3 → 1.1.0

package/dist/service.js

@@ -4,14 +4,9 @@ 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 { AsyncLocalStorage } from 'node:async_hooks';
-import { createRequire } from 'node:module';
-import { Controller, Get, Post } from '@fluojs/http';
 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 { handleProtocols } from 'graphql-ws';
-import { useServer } from 'graphql-ws/lib/use/ws';
-import { WebSocketServer } from 'ws';
 import { discoverResolverDescriptors } from './discovery.js';
 import { createGraphqlValidationPlugin, resolveGraphqlRequestLimits } from './guardrails.js';
 import { GRAPHQL_INTERNAL_MODULE_OPTIONS_TOKEN } from './internal-tokens.js';
@@ -24,13 +19,6 @@ const DEFAULT_GRAPHQL_WEBSOCKET_LIMITS = {
   maxOperationsPerConnection: 25,
   maxPayloadBytes: 64 * 1024
 };
-function hasNodeUpgradeServer(value) {
-  if (typeof value !== 'object' || value === null) {
-    return false;
-  }
-  const server = value;
-  return typeof server.on === 'function' && typeof server.off === 'function';
-}
 function buildFrameworkRequestFromFetchRequest(request) {
   const requestUrl = new URL(request.url);
   return {
@@ -45,39 +33,6 @@ function buildFrameworkRequestFromFetchRequest(request) {
     url: requestUrl.pathname + requestUrl.search
   };
 }
-function buildFrameworkRequestFromIncomingMessage(request) {
-  const requestUrl = new URL(request.url ?? '/graphql', 'http://localhost');
-  return {
-    cookies: {},
-    headers: request.headers,
-    method: request.method ?? 'GET',
-    params: {},
-    path: requestUrl.pathname,
-    query: Object.fromEntries(requestUrl.searchParams.entries()),
-    raw: request,
-    url: requestUrl.pathname + requestUrl.search
-  };
-}
-function isConnectionParamsRecord(value) {
-  return typeof value === 'object' && value !== null && !Array.isArray(value);
-}
-function closeWebSocketServer(server) {
-  return new Promise((resolve, reject) => {
-    server.close(error => {
-      if (error?.message === 'The server is not running') {
-        resolve();
-        return;
-      }
-      if (error) {
-        reject(error);
-        return;
-      }
-      resolve();
-    });
-  });
-}
-const graphqlRequestContextStorage = new AsyncLocalStorage();
-const runtimeRequire = createRequire(import.meta.url);
 let graphqlInstanceOfPatchRefCount = 0;
 let restoreGraphqlInstanceOfPatch;
 const allowedCrossRealmGraphqlObjects = new WeakSet();
@@ -108,16 +63,17 @@ class GraphqlEndpointController {
 }
 export { _GraphqlEndpointContr as GraphqlEndpointController };
 function getCrossRealmGraphqlTag(value, constructor) {
-  const className = constructor.prototype?.[Symbol.toStringTag];
+  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;
   }
-  if (Symbol.toStringTag in value) {
-    const valueClassName = value[Symbol.toStringTag];
-    return valueClassName === className ? className : 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;
@@ -131,7 +87,8 @@ function markAllowedCrossRealmGraphqlObjects(value, visited = new WeakSet()) {
   }
   visited.add(value);
   const tag = value[Symbol.toStringTag];
-  if (typeof tag === 'string' && tag.startsWith('GraphQL')) {
+  const constructorName = value.constructor?.name;
+  if (typeof tag === 'string' && tag.startsWith('GraphQL') || typeof constructorName === 'string' && constructorName.startsWith('GraphQL')) {
     allowedCrossRealmGraphqlObjects.add(value);
   }
   if (Array.isArray(value)) {
@@ -150,8 +107,7 @@ function isAllowedCrossRealmGraphqlObject(value, constructor) {
   }
   return allowedCrossRealmGraphqlObjects.has(value) && getCrossRealmGraphqlTag(value, constructor) !== undefined;
 }
-function installGraphqlInstanceOfPatch() {
-  const instanceOfModule = runtimeRequire('graphql/jsutils/instanceOf.js');
+function installGraphqlInstanceOfPatch(instanceOfModule) {
   if (restoreGraphqlInstanceOfPatch) {
     graphqlInstanceOfPatchRefCount += 1;
     return releaseGraphqlInstanceOfPatch;
@@ -192,8 +148,10 @@ function releaseGraphqlInstanceOfPatch() {
   restoreGraphqlInstanceOfPatch = undefined;
 }
 async function loadGraphqlDeps() {
-  const graphqlMod = runtimeRequire('graphql');
-  const yogaMod = runtimeRequire('graphql-yoga');
+  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)]);
   return {
     GraphQLError: graphqlMod.GraphQLError,
     GraphQLBoolean: graphqlMod.GraphQLBoolean,
@@ -201,13 +159,16 @@ async function loadGraphqlDeps() {
     GraphQLID: graphqlMod.GraphQLID,
     GraphQLInt: graphqlMod.GraphQLInt,
     GraphQLList: graphqlMod.GraphQLList,
+    GraphQLNonNull: graphqlMod.GraphQLNonNull,
     GraphQLObjectType: graphqlMod.GraphQLObjectType,
     GraphQLSchema: graphqlMod.GraphQLSchema,
     GraphQLString: graphqlMod.GraphQLString,
     GraphQLUnionType: graphqlMod.GraphQLUnionType,
     buildSchema: graphqlMod.buildSchema,
+    createGraphQLError: yogaMod.createGraphQLError,
     createYoga: yogaMod.createYoga,
     execute: graphqlMod.execute,
+    instanceOfModule,
     subscribe: graphqlMod.subscribe
   };
 }
@@ -223,11 +184,9 @@ class GraphqlLifecycleService {
   graphQLErrorConstructor;
   middlewareRegistered = false;
   operationContainers = new WeakMap();
+  requestContexts = new WeakMap();
   websocketOperationContainers = new Map();
-  websocketDisposable;
-  websocketServer;
-  websocketUpgradeListener;
-  websocketUpgradeServer;
+  websocketTransport;
   executeGraphqlOperation;
   releaseGraphqlInstanceOfPatch;
   subscribeGraphqlOperation;
@@ -251,13 +210,15 @@ class GraphqlLifecycleService {
       }
       try {
         const fetchRequest = toFetchRequest(context.request);
+        this.requestContexts.set(fetchRequest, {
+          principal: context.requestContext.principal,
+          request: context.request
+        });
         try {
-          const fetchResponse = await graphqlRequestContextStorage.run({
-            principal: context.requestContext.principal,
-            request: context.request
-          }, () => yoga.fetch(fetchRequest));
+          const fetchResponse = await yoga.fetch(fetchRequest);
           await writeFetchResponse(fetchResponse, context.response);
         } finally {
+          this.requestContexts.delete(fetchRequest);
           await this.disposeOperationContainer(fetchRequest);
         }
       } catch (error) {
@@ -304,7 +265,7 @@ class GraphqlLifecycleService {
         } : {}),
         schema
       });
-      this.registerWebSocketTransport();
+      await this.registerWebSocketTransport();
       this.registerMiddleware();
       this.middlewareRegistered = true;
     } catch (error) {
@@ -348,7 +309,7 @@ class GraphqlLifecycleService {
     };
   }
   resolveSchema(deps) {
-    this.releaseGraphqlInstanceOfPatch ??= installGraphqlInstanceOfPatch();
+    this.releaseGraphqlInstanceOfPatch ??= installGraphqlInstanceOfPatch(deps.instanceOfModule);
     return resolveSchema(deps, this.options.schema, () => this.createCodeFirstSchema(deps), markAllowedCrossRealmGraphqlObjects);
   }
   createCodeFirstSchema(deps) {
@@ -386,7 +347,7 @@ class GraphqlLifecycleService {
     }
   }
   buildGraphqlContext(request, requestContextOverride, operationContainerOverride) {
-    const storedContext = graphqlRequestContextStorage.getStore();
+    const storedContext = this.requestContexts.get(request);
     const requestContext = {
       connectionParams: requestContextOverride?.connectionParams,
       principal: requestContextOverride?.principal ?? storedContext?.principal,
@@ -404,85 +365,44 @@ class GraphqlLifecycleService {
       [GRAPHQL_OPERATION_CONTAINER]: operationContainer
     };
   }
-  registerWebSocketTransport() {
-    if (!this.isWebSocketTransportEnabled() || this.yoga === undefined || this.websocketUpgradeListener !== undefined) {
+  async registerWebSocketTransport() {
+    if (!this.isWebSocketTransportEnabled() || this.yoga === undefined || this.websocketTransport !== undefined) {
       return;
     }
-    const upgradeServer = this.resolveUpgradeServer();
-    const websocketLimits = this.resolveWebSocketLimits();
-    const websocketServer = new WebSocketServer({
-      handleProtocols: protocols => handleProtocols(protocols),
-      maxPayload: websocketLimits?.maxPayloadBytes ?? 0,
-      noServer: true
-    });
-    const upgradeListener = (request, socket, head) => {
-      const targetPath = new URL(request.url ?? '/', 'http://localhost').pathname;
-      if (!isGraphqlPath(targetPath)) {
-        return;
-      }
-      if (websocketLimits && websocketServer.clients.size >= websocketLimits.maxConnections) {
-        this.rejectWebSocketUpgrade(socket, 503, 'GraphQL websocket connection count exceeds the configured limit.');
-        return;
-      }
-      websocketServer.handleUpgrade(request, socket, head, websocket => {
-        websocketServer.emit('connection', websocket, request);
-      });
-    };
-    const websocketDisposable = useServer({
-      connectionInitWaitTimeout: this.options.subscriptions?.websocket?.connectionInitWaitTimeoutMs,
+    const {
+      createNodeGraphqlWebSocketTransport
+    } = await import('./node/graphql-websocket-transport.js');
+    this.websocketTransport = await createNodeGraphqlWebSocketTransport({
+      adapter: this.adapter,
+      connectionInitWaitTimeoutMs: this.options.subscriptions?.websocket?.connectionInitWaitTimeoutMs,
       execute: args => {
         if (!this.executeGraphqlOperation) {
           throw new Error('GraphQL execute function not initialized.');
         }
         return this.executeGraphqlOperation(args);
       },
-      onComplete: async (context, message) => {
-        await this.disposeWebSocketOperationContainer(context.extra.socket, message.id);
-      },
-      onDisconnect: async context => {
-        await this.disposeAllWebSocketOperationContainers(context.extra.socket);
-      },
-      onSubscribe: async (context, message) => this.handleWebSocketSubscribe(context, message.id, message.payload),
+      keepAliveMs: this.options.subscriptions?.websocket?.keepAliveMs,
+      limits: this.resolveWebSocketLimits(),
+      onComplete: (socketKey, operationId) => this.disposeWebSocketOperationContainer(socketKey, operationId),
+      onDisconnect: socketKey => this.disposeAllWebSocketOperationContainers(socketKey),
+      onSubscribe: request => this.handleWebSocketSubscribe(request),
       subscribe: args => {
         if (!this.subscribeGraphqlOperation) {
           throw new Error('GraphQL subscribe function not initialized.');
         }
         return this.subscribeGraphqlOperation(args);
       }
-    }, websocketServer, this.options.subscriptions?.websocket?.keepAliveMs);
-    upgradeServer.on('upgrade', upgradeListener);
-    this.websocketDisposable = websocketDisposable;
-    this.websocketServer = websocketServer;
-    this.websocketUpgradeListener = upgradeListener;
-    this.websocketUpgradeServer = upgradeServer;
+    });
   }
   async unregisterWebSocketTransport() {
-    if (this.websocketUpgradeListener && this.websocketUpgradeServer) {
-      this.websocketUpgradeServer.off('upgrade', this.websocketUpgradeListener);
-    }
-    this.websocketUpgradeListener = undefined;
-    this.websocketUpgradeServer = undefined;
-    if (this.websocketServer) {
-      for (const client of this.websocketServer.clients) {
-        client.terminate();
-      }
-    }
-    if (this.websocketDisposable) {
+    if (this.websocketTransport) {
       try {
-        await this.websocketDisposable.dispose();
+        await this.websocketTransport.dispose();
       } catch (error) {
         this.logger.error('Failed to dispose GraphQL websocket transport.', error, 'GraphqlLifecycleService');
       }
     }
-    this.websocketDisposable = undefined;
-    if (this.websocketServer) {
-      try {
-        await closeWebSocketServer(this.websocketServer);
-      } catch (error) {
-        this.logger.error('Failed to close GraphQL websocket server.', error, 'GraphqlLifecycleService');
-      }
-    }
-    this.websocketServer = undefined;
+    this.websocketTransport = undefined;
     for (const socketKey of this.websocketOperationContainers.keys()) {
       await this.disposeAllWebSocketOperationContainers(socketKey);
     }
@@ -490,32 +410,21 @@ class GraphqlLifecycleService {
   isWebSocketTransportEnabled() {
     return this.options.subscriptions?.websocket?.enabled === true;
   }
-  resolveUpgradeServer() {
-    if (typeof this.adapter.getServer !== 'function') {
-      throw new Error('GraphQL websocket subscriptions require an HTTP adapter with getServer(). Use the Node HTTP adapter or provide a compatible adapter implementation.');
-    }
-    const server = this.adapter.getServer();
-    if (!hasNodeUpgradeServer(server)) {
-      throw new Error('GraphQL websocket subscriptions require adapter.getServer() to return a Node HTTP/S server that supports upgrade listeners.');
-    }
-    return server;
-  }
-  async handleWebSocketSubscribe(context, operationId, payload) {
+  async handleWebSocketSubscribe(request) {
     const yoga = this.yoga;
     if (!yoga) {
       throw new Error('GraphQL server not initialized.');
     }
-    const websocketLimitError = this.createWebSocketOperationLimitError(context.extra.socket, operationId);
+    const websocketLimitError = this.createWebSocketOperationLimitError(request.socket, request.operationId);
     if (websocketLimitError) {
       return [websocketLimitError];
     }
-    const frameworkRequest = buildFrameworkRequestFromIncomingMessage(context.extra.request);
-    const fetchRequest = toFetchRequest(frameworkRequest);
-    const operationContainer = this.getOrCreateWebSocketOperationContainer(context.extra.socket, operationId);
+    const fetchRequest = toFetchRequest(request.request);
+    const operationContainer = this.getOrCreateWebSocketOperationContainer(request.socket, request.operationId);
     const graphqlContext = this.buildGraphqlContext(fetchRequest, {
-      connectionParams: isConnectionParamsRecord(context.connectionParams) ? context.connectionParams : undefined,
-      request: frameworkRequest,
-      socket: context.extra.socket
+      connectionParams: request.connectionParams,
+      request: request.request,
+      socket: request.socket
     }, operationContainer);
     try {
       const {
@@ -527,21 +436,21 @@ class GraphqlLifecycleService {
         request: fetchRequest,
         [GRAPHQL_CONTEXT_OVERRIDE]: graphqlContext
       });
-      const document = parse(payload.query);
+      const document = parse(request.payload.query);
       const validationErrors = validate(schema, document);
       if (validationErrors.length > 0) {
-        await this.disposeWebSocketOperationContainer(context.extra.socket, operationId);
+        await this.disposeWebSocketOperationContainer(request.socket, request.operationId);
         return validationErrors;
       }
       return {
         contextValue: await contextFactory(),
         document,
-        operationName: payload.operationName ?? undefined,
+        operationName: request.payload.operationName ?? undefined,
         schema,
-        variableValues: payload.variables
+        variableValues: request.payload.variables
       };
     } catch (error) {
-      await this.disposeWebSocketOperationContainer(context.extra.socket, operationId);
+      await this.disposeWebSocketOperationContainer(request.socket, request.operationId);
       throw error;
     }
   }
@@ -560,15 +469,6 @@ class GraphqlLifecycleService {
     }
     return new GraphQLError(`GraphQL websocket active operation count exceeds the configured limit of ${String(limits.maxOperationsPerConnection)}.`);
   }
-  rejectWebSocketUpgrade(socket, statusCode, message) {
-    if (!socket.writable) {
-      socket.destroy();
-      return;
-    }
-    const body = `${message}\n`;
-    socket.write([`HTTP/1.1 ${String(statusCode)} ${statusCode === 503 ? 'Service Unavailable' : 'Bad Request'}`, 'Connection: close', 'Content-Type: text/plain; charset=utf-8', `Content-Length: ${String(Buffer.byteLength(body))}`, '', body].join('\r\n'));
-    socket.destroy();
-  }
   getOrCreateWebSocketOperationContainer(socketKey, operationId) {
     const existingSocketContainers = this.websocketOperationContainers.get(socketKey);
     if (existingSocketContainers?.has(operationId)) {

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;AAsED;;;;;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;AAgGD;;;;;;GAMG;AACH,wBAAsB,kBAAkB,CAAC,aAAa,EAAE,QAAQ,EAAE,iBAAiB,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC,CA+BrH"}

package/dist/transport/transport.js

@@ -34,13 +34,18 @@ function createFetchHeaders(request) {
   }
   return headers;
 }
+function copyBytesToArrayBuffer(bytes) {
+  const body = new ArrayBuffer(bytes.byteLength);
+  new Uint8Array(body).set(bytes);
+  return body;
+}
 function createFetchBody(request, headers) {
   const method = request.method.toUpperCase();
   if (method === 'GET' || method === 'HEAD') {
     return undefined;
   }
   if (request.rawBody) {
-    return Buffer.from(request.rawBody);
+    return copyBytesToArrayBuffer(request.rawBody);
   }
   if (request.body === undefined) {
     return undefined;
@@ -49,10 +54,10 @@ function createFetchBody(request, headers) {
     return request.body;
   }
   if (request.body instanceof Uint8Array) {
-    return Buffer.from(request.body);
+    return copyBytesToArrayBuffer(request.body);
   }
   if (request.body instanceof ArrayBuffer) {
-    return Buffer.from(request.body);
+    return request.body;
   }
   if (!headers.has('content-type')) {
     headers.set('content-type', 'application/json; charset=utf-8');

package/dist/types.d.ts

@@ -99,9 +99,20 @@ export interface ResolverMetadata {
     typeName: string;
 }
 /**
- * Supported GraphQL operation handler categories.
+ * Supported GraphQL root-operation and object-field handler categories.
  */
-export type ResolverHandlerType = 'query' | 'mutation' | 'subscription';
+export type ResolverHandlerType = 'query' | 'mutation' | 'subscription' | 'field';
+/**
+ * Explicit source kinds that can be bound to object field-resolver parameters.
+ */
+export type FieldResolverParameterKind = 'parent' | 'context';
+/**
+ * Describes one positional parameter binding for an object field resolver.
+ */
+export interface FieldResolverParameterBindingMetadata {
+    index: number;
+    kind: FieldResolverParameterKind;
+}
 /**
  * Scalar names supported by the code-first schema helpers.
  */
@@ -157,6 +168,7 @@ export interface ResolverHandlerMetadata {
     inputClass?: Function;
     argTypes?: Record<string, GraphqlArgType>;
     outputType?: GraphqlRootOutputType;
+    nullable?: boolean;
 }
 /**
  * Describes how one method parameter maps to a named GraphQL argument.
@@ -177,6 +189,8 @@ export interface ResolverHandlerDescriptor {
     argFields: ArgFieldMetadata[];
     argTypes?: Record<string, GraphqlArgType>;
     outputType?: GraphqlRootOutputType;
+    nullable?: boolean;
+    parameterBindings: FieldResolverParameterBindingMetadata[];
 }
 /**
  * Fully discovered resolver descriptor used by the GraphQL runtime.

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

@@ -48,7 +48,15 @@ export const GRAPHQL_REQUEST_SCOPED_LOADER_CACHE = Symbol.for('fluo.graphql.requ
  */
 
 /**
- * Supported GraphQL operation handler categories.
+ * Supported GraphQL root-operation and object-field handler categories.
+ */
+
+/**
+ * Explicit source kinds that can be bound to object field-resolver parameters.
+ */
+
+/**
+ * Describes one positional parameter binding for an object field resolver.
  */
 
 /**

package/package.json

@@ -9,7 +9,7 @@
     "yoga",
     "api"
   ],
-  "version": "1.0.3",
+  "version": "1.1.0",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -18,7 +18,7 @@
     "directory": "packages/graphql"
   },
   "engines": {
-    "node": ">=20.0.0"
+    "node": ">=20.16.0"
   },
   "publishConfig": {
     "access": "public"
@@ -41,11 +41,11 @@
     "graphql-ws": "^5.16.2",
     "graphql-yoga": "^5.18.1",
     "ws": "^8.18.3",
-    "@fluojs/core": "^1.0.3",
-    "@fluojs/di": "^1.0.3",
-    "@fluojs/http": "^1.1.0",
-    "@fluojs/runtime": "^1.1.1",
-    "@fluojs/validation": "^1.0.4"
+    "@fluojs/core": "^1.1.0",
+    "@fluojs/di": "^2.0.0",
+    "@fluojs/http": "^2.0.1",
+    "@fluojs/runtime": "^2.0.1",
+    "@fluojs/validation": "^1.0.6"
   },
   "devDependencies": {
     "@types/ws": "^8.18.1",