graphql-hive · enisdenjo · Nov 11, 2025 · Feb 5, 2025 · Feb 6, 2025 · Feb 6, 2025
diff --git a/.changeset/lizard-chest.md b/.changeset/lizard-chest.md
@@ -0,0 +1,7 @@
+---
+'@graphql-hive/router-runtime': major
+---
+
+Hive Router Runtime for Hive Gateway
+
+[Read more about it in the documentation.](https://the-guild.dev/graphql/hive/docs/gateway/other-features/router-runtime)
diff --git a/.changeset/sharp-cars-act.md b/.changeset/sharp-cars-act.md
@@ -0,0 +1,7 @@
+---
+'@graphql-mesh/fusion-runtime': minor
+---
+
+Support changing the unified graph handler
+
+Allowing users to integrate other query planners, like the new [Hive Gateway Router Runtime](https://the-guild.dev/graphql/hive/docs/gateway/other-features/router-runtime).
diff --git a/.github/workflows/memtest.yml b/.github/workflows/memtest.yml
@@ -18,18 +18,27 @@ jobs:
     strategy:
       fail-fast: false
       matrix:
-        test_name:
-          - auto-type-merging
-          - federation-example
-          - federation-mixed
-          - federation-subscriptions-passthrough
-          - opentelemetry
-          - programmatic-batching
-          - logger
+        test:
+          - name: auto-type-merging
+            hive-router-runtime: 0
+          - name: federation-example
+            hive-router-runtime: 0
+          - name: federation-example
+            hive-router-runtime: 1
+          - name: federation-mixed
+            hive-router-runtime: 0
+          - name: federation-subscriptions-passthrough
+            hive-router-runtime: 0
+          - name: opentelemetry
+            hive-router-runtime: 0
+          - name: programmatic-batching
+            hive-router-runtime: 0
+          - name: logger
+            hive-router-runtime: 0
         e2e_runner:
           - node
           # - bun TODO: get memory snaps and heap sampling for bun. is it even necessary?
-    name: ${{matrix.e2e_runner}} / ${{matrix.test_name}}
+    name: ${{matrix.e2e_runner}} / ${{matrix.test.name}} ${{ matrix.test.hive-router-runtime && 'with hive router runtime' || '' }}
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
@@ -59,13 +68,14 @@ jobs:
           key: docker-images-${{ runner.os }}-${{ steps.hash-docker-images.outputs.result }}
       - name: Test
         env:
+          HIVE_ROUTER_RUNTIME: ${{matrix.test.hive-router-runtime}}
           E2E_GATEWAY_RUNNER: ${{matrix.e2e_runner}}
-        run: yarn test:mem ${{matrix.test_name}}
+        run: yarn test:mem ${{matrix.test.name}}
       - name: Upload heap snapshots
         if: failure()
         uses: actions/upload-artifact@v5
         with:
-          name: ${{matrix.test_name}}-heap-snapshots
+          name: ${{matrix.test.name}}-heap-snapshots
           path: |
-            e2e/${{matrix.test_name}}/*.heapsnapshot
+            e2e/${{matrix.test.name}}/*.heapsnapshot
             packages/logger/tests/*.heapsnapshot
diff --git a/.github/workflows/test.yml b/.github/workflows/test.yml
@@ -33,7 +33,11 @@ jobs:
         uses: the-guild-org/shared-config/setup@v1
         with:
           node-version: ${{matrix.node-version}}
-      - name: Test
+      - name: Test with Stitching Runtime
+        run: yarn test
+      - name: Test with Router Runtime
+        env:
+          HIVE_ROUTER_RUNTIME: 1
         run: yarn test
 
   unit-bun:
@@ -46,12 +50,20 @@ jobs:
         uses: the-guild-org/shared-config/setup@v1
         with:
           node-version-file: .node-version
-      - name: Test
+      - name: Test with Stitching Runtime
         uses: nick-fields/retry@ce71cc2ab81d554ebbe88c79ab5975992d79ba08 # v3
         with:
           timeout_minutes: 10
           max_attempts: 3
           command: yarn test:bun
+      - name: Test with Router Runtime
+        uses: nick-fields/retry@ce71cc2ab81d554ebbe88c79ab5975992d79ba08 # v3
+        env:
+          HIVE_ROUTER_RUNTIME: 1
+        with:
+          timeout_minutes: 10
+          max_attempts: 3
+          command: yarn test:bun
 
   leaks:
     strategy:
@@ -72,12 +84,20 @@ jobs:
         uses: the-guild-org/shared-config/setup@v1
         with:
           node-version: ${{matrix.node-version}}
-      - name: Run Tests
+      - name: Test with Stitching Runtime
         uses: nick-fields/retry@ce71cc2ab81d554ebbe88c79ab5975992d79ba08 # v3
         with:
           timeout_minutes: 10
           max_attempts: 3
           command: yarn test:leaks
+      - name: Test with Router Runtime
+        uses: nick-fields/retry@ce71cc2ab81d554ebbe88c79ab5975992d79ba08 # v3
+        env:
+          HIVE_ROUTER_RUNTIME: 1
+        with:
+          timeout_minutes: 10
+          max_attempts: 3
+          command: yarn test:leaks
 
   e2e:
     runs-on: ${{ matrix.setup.os }}
@@ -89,48 +109,68 @@ jobs:
           - workflow-name: Node 20 on Ubuntu
             os: ubuntu-latest
             gateway-runner: node
+            hive-router-runtime: 0
             node-version: 20
           - workflow-name: Node 22 on Ubuntu
             os: ubuntu-latest
             gateway-runner: node
+            hive-router-runtime: 0
             node-version: 22
           - workflow-name: Node 24 on Ubuntu
             os: ubuntu-latest
             gateway-runner: node
+            hive-router-runtime: 0
             node-version: 24
           - workflow-name: Node 25 on Ubuntu
             os: ubuntu-latest
             gateway-runner: node
+            hive-router-runtime: 0
+            node-version: 25
+          - workflow-name: Node 25 on Ubuntu with Router Runtime
+            os: ubuntu-latest
+            gateway-runner: node
+            hive-router-runtime: 1
             node-version: 25
 
           # Node on Docker
           - workflow-name: Node Docker on Ubuntu
             os: ubuntu-latest
             gateway-runner: docker
+            hive-router-runtime: 0
 
           # Node Binary
           - workflow-name: Node Binary on Ubuntu
             os: ubuntu-latest
             gateway-runner: bin
+            hive-router-runtime: 0
           - workflow-name: Node Binary on Windows
             os: windows-latest
             gateway-runner: bin
+            hive-router-runtime: 0
 
           # Should be the same with Linux
           # - workflow-name: Node Binary on MacOS Arm64
           #   os: macos-14 # MacOS Arm64
           #   gateway-runner: bin
+          #   hive-router-runtime: 0
           # - workflow-name: Node Binary on MacOS x86_64
           #   os: macos-13 # MacOS x86_64
           #   gateway-runner: bin
+          #   hive-router-runtime: 0
 
           # Bun
           - workflow-name: Bun on Ubuntu
             os: ubuntu-latest
             gateway-runner: bun
+            hive-router-runtime: 0
+          - workflow-name: Bun on Ubuntu with Router Runtime
+            os: ubuntu-latest
+            gateway-runner: bun
+            hive-router-runtime: 1
           - workflow-name: Bun Docker on Ubuntu
             os: ubuntu-latest
             gateway-runner: bun-docker
+            hive-router-runtime: 0
 
     name: E2E / ${{matrix.setup.workflow-name}}
     steps:
@@ -208,6 +248,7 @@ jobs:
           max_attempts: 3
           command: yarn test:e2e
         env:
+          HIVE_ROUTER_RUNTIME: ${{matrix.setup.hive-router-runtime}}
           E2E_GATEWAY_RUNNER: ${{matrix.setup.gateway-runner}}
           E2E_TEST_APOLLO_GRAPH_REF: ${{secrets.E2E_TEST_APOLLO_GRAPH_REF}}
           E2E_TEST_APOLLO_KEY: ${{secrets.E2E_TEST_APOLLO_KEY}}

diff --git a/e2e/aws-sigv4/aws-sigv4.e2e.ts b/e2e/aws-sigv4/aws-sigv4.e2e.ts
@@ -1,4 +1,5 @@
 import { createTenv } from '@internal/e2e';
+import { usingHiveRouterRuntime } from '~internal/env';
 import { describe, expect, it } from 'vitest';
 
 const AWS_ACCESS_KEY_ID = 'AKIAIOSFODNN7EXAMPLE';
@@ -63,9 +64,13 @@ describe('AWS Sigv4', () => {
       `,
     });
     expect(result).toEqual({
-      data: {
-        hello: null,
-      },
+      ...(usingHiveRouterRuntime()
+        ? {}
+        : {
+            data: {
+              hello: null,
+            },
+          }),
       errors: [
         {
           message: 'Expected access key AKIAIOSFODNN7EXAMPLE, but got invalid',

diff --git a/e2e/federation-example/federation-example.bench.ts b/e2e/federation-example/federation-example.bench.ts
@@ -9,23 +9,31 @@ import { fetch } from '@whatwg-node/fetch';
 import { bench, describe, expect } from 'vitest';
 
 describe('Gateway', async () => {
-  const { gateway, service } = createTenv(__dirname);
+  const { gateway, service: _service } = createTenv(__dirname);
   const example = createExampleSetup(__dirname, 1000);
 
   const supergraph = await example.supergraph();
 
   const gateways: Record<string, Gateway | Service> = {
-    'Apollo Gateway': await service('apollo-gateway', {
+    // TODO: tests are failing for whatever reason
+    // 'Apollo Gateway': await service('apollo-gateway', {
+    //   env: {
+    //     SUPERGRAPH: supergraph,
+    //   },
+    // }),
+    'Hive Gateway w/ Tools': await gateway({
+      supergraph,
       env: {
-        SUPERGRAPH: supergraph,
+        FORK: 1,
+        NODE_ENV: 'production',
       },
     }),
-    'Hive Gateway': await gateway({
+    'Hive Gateway w/ Hive Router Query Planner': await gateway({
       supergraph,
-      args: ['--jit'],
       env: {
-        JIT: 'true',
+        FORK: 1,
         NODE_ENV: 'production',
+        HIVE_ROUTER_RUNTIME: 1,
       },
     }),
   };

diff --git a/e2e/nestjs/package.json b/e2e/nestjs/package.json
@@ -2,16 +2,5 @@
   "name": "@e2e/nestjs",
   "version": "0.0.1",
   "type": "module",
-  "private": true,
-  "dependencies": {
-    "@graphql-hive/nestjs": "workspace:^",
-    "@nestjs/common": "^11.1.8",
-    "@nestjs/core": "^11.1.8",
-    "@nestjs/graphql": "^13.2.0",
-    "@nestjs/platform-express": "^11.1.8",
-    "file-type": "^21.1.0",
-    "graphql": "^16.12.0",
-    "reflect-metadata": "^0.2.2",
-    "rxjs": "^7.8.1"
-  }
+  "private": true
 }
diff --git a/e2e/opentelemetry/opentelemetry.e2e.ts b/e2e/opentelemetry/opentelemetry.e2e.ts
@@ -1,7 +1,7 @@
 import os from 'os';
 import { setTimeout } from 'timers/promises';
 import { createExampleSetup, createTenv, type Container } from '@internal/e2e';
-import { isCI } from '@internal/testing';
+import { isCI, usingHiveRouterRuntime } from '@internal/testing';
 import { crypto, fetch } from '@whatwg-node/fetch';
 import { beforeAll, describe, expect, it } from 'vitest';
 
@@ -225,8 +225,8 @@ describe('OpenTelemetry', () => {
           const expectedExecuteChildren = [
             ['subgraph.execute (accounts)', 2],
             ['subgraph.execute (products)', 2],
-            ['subgraph.execute (inventory)', 1],
-            ['subgraph.execute (reviews)', 2],
+            ['subgraph.execute (inventory)', usingHiveRouterRuntime() ? 2 : 1],
+            ['subgraph.execute (reviews)', usingHiveRouterRuntime() ? 1 : 2],
           ] as const;
 
           for (const [operationName, count] of expectedExecuteChildren) {
@@ -338,8 +338,8 @@ describe('OpenTelemetry', () => {
           const expectedExecuteChildren = [
             ['subgraph.execute (accounts)', 2],
             ['subgraph.execute (products)', 2],
-            ['subgraph.execute (inventory)', 1],
-            ['subgraph.execute (reviews)', 2],
+            ['subgraph.execute (inventory)', usingHiveRouterRuntime() ? 2 : 1],
+            ['subgraph.execute (reviews)', usingHiveRouterRuntime() ? 1 : 2],
           ] as const;
 
           for (const [operationName, count] of expectedExecuteChildren) {

diff --git a/examples/apq-subgraphs/example.tar.gz b/examples/apq-subgraphs/example.tar.gz