Progressive Override #1624

ardatan · 2025-10-24T11:33:27Z

Ref GW-323
Closes #1082

Support for Progressive Override

Handles percent(x) usage by default
Documentation -> docs(gateway): progressive override console#7168
Maybe tests for percent( usage

If you have labels like below;

type Foo {
   # If label is active, it overrides `Foo.bar` from A, and use this subgraph not A.
   bar: String @override(from: "A", label: "my_custom_label")
}

defineConfig({
  // You can control the label through headers like below;
  progressiveOverride(label, context) {
     if (label === 'my_custom_label' && context.request.headers.has('x-use-my-custom-label')) {
        return true;
     }
     return false;
  }
})

kamilkisiela · 2025-10-24T11:38:18Z

packages/federation/src/supergraph.ts

+
+          const label = fieldInfo.label;
+          // Extract 10 from percent(10) for example
+          const percentRegexp = /^percent\((\d{1,3})\)$/;


A valid value for percentage is, I think, up to 8 digits or something

Hmm I guess they don't have a limit;
https://github.com/apollographql/router/blob/dev/apollo-router/src/plugins/progressive_override/mod.rs#L113
But they parse it as float so I should remove the limit too.

The "limit" is limited by the producer of supergraph (composition - longer numbers fail composition)

So we don't need to limit it as it is right now, no?

theguild-bot · 2025-10-24T11:41:25Z

🚀 Snapshot Release (`alpha`)

The latest changes of this PR are available as alpha on npm (based on the declared changesets):

Package	Version	Info
`@graphql-tools/batch-delegate`	`10.0.2-alpha-55039db9b96449b3de63ec097f58c0d4ff28eb08`	npm ↗︎ unpkg ↗︎
`@graphql-tools/delegate`	`11.1.0-alpha-55039db9b96449b3de63ec097f58c0d4ff28eb08`	npm ↗︎ unpkg ↗︎
`@graphql-tools/federation`	`4.1.0-alpha-55039db9b96449b3de63ec097f58c0d4ff28eb08`	npm ↗︎ unpkg ↗︎
`@graphql-mesh/fusion-runtime`	`1.3.0-alpha-55039db9b96449b3de63ec097f58c0d4ff28eb08`	npm ↗︎ unpkg ↗︎
`@graphql-hive/gateway`	`2.1.11-alpha-55039db9b96449b3de63ec097f58c0d4ff28eb08`	npm ↗︎ unpkg ↗︎
`@graphql-hive/logger`	`1.0.7-alpha-55039db9b96449b3de63ec097f58c0d4ff28eb08`	npm ↗︎ unpkg ↗︎
`@graphql-hive/nestjs`	`2.0.16-alpha-55039db9b96449b3de63ec097f58c0d4ff28eb08`	npm ↗︎ unpkg ↗︎
`@graphql-hive/plugin-aws-sigv4`	`2.0.11-alpha-55039db9b96449b3de63ec097f58c0d4ff28eb08`	npm ↗︎ unpkg ↗︎
`@graphql-hive/plugin-opentelemetry`	`1.0.13-alpha-55039db9b96449b3de63ec097f58c0d4ff28eb08`	npm ↗︎ unpkg ↗︎
`@graphql-mesh/plugin-prometheus`	`2.0.14-alpha-55039db9b96449b3de63ec097f58c0d4ff28eb08`	npm ↗︎ unpkg ↗︎
`@graphql-hive/gateway-runtime`	`2.2.0-alpha-55039db9b96449b3de63ec097f58c0d4ff28eb08`	npm ↗︎ unpkg ↗︎
`@graphql-tools/stitch`	`10.1.0-alpha-55039db9b96449b3de63ec097f58c0d4ff28eb08`	npm ↗︎ unpkg ↗︎
`@graphql-tools/stitching-directives`	`4.0.2-alpha-55039db9b96449b3de63ec097f58c0d4ff28eb08`	npm ↗︎ unpkg ↗︎
`@graphql-mesh/transport-common`	`1.0.7-alpha-55039db9b96449b3de63ec097f58c0d4ff28eb08`	npm ↗︎ unpkg ↗︎
`@graphql-mesh/transport-http`	`1.0.7-alpha-55039db9b96449b3de63ec097f58c0d4ff28eb08`	npm ↗︎ unpkg ↗︎
`@graphql-mesh/transport-http-callback`	`1.0.7-alpha-55039db9b96449b3de63ec097f58c0d4ff28eb08`	npm ↗︎ unpkg ↗︎
`@graphql-mesh/transport-ws`	`2.0.7-alpha-55039db9b96449b3de63ec097f58c0d4ff28eb08`	npm ↗︎ unpkg ↗︎
`@graphql-tools/wrap`	`11.0.2-alpha-55039db9b96449b3de63ec097f58c0d4ff28eb08`	npm ↗︎ unpkg ↗︎

theguild-bot · 2025-10-24T11:44:53Z

🚀 Snapshot Release (Binary for `macOS-ARM64`)

The latest changes of this PR are available for download (based on the declared changesets).

theguild-bot · 2025-10-24T11:45:05Z

🚀 Snapshot Release (Binary for `Linux-ARM64`)

The latest changes of this PR are available for download (based on the declared changesets).

theguild-bot · 2025-10-24T11:45:21Z

🚀 Snapshot Release (Binary for `Linux-X64`)

The latest changes of this PR are available for download (based on the declared changesets).

theguild-bot · 2025-10-24T11:47:51Z

🚀 Snapshot Release (Binary for `macOS-X64`)

The latest changes of this PR are available for download (based on the declared changesets).

theguild-bot · 2025-10-24T11:51:17Z

🚀 Snapshot Release (Node Docker Image)

The latest changes of this PR are available as image on GitHub Container Registry (based on the declared changesets):

ghcr.io/graphql-hive/gateway:2.1.11-alpha-55039db9b96449b3de63ec097f58c0d4ff28eb08

theguild-bot · 2025-10-24T11:52:04Z

🚀 Snapshot Release (Bun Docker Image)

The latest changes of this PR are available as image on GitHub Container Registry (based on the declared changesets):

ghcr.io/graphql-hive/gateway:2.1.11-alpha-55039db9b96449b3de63ec097f58c0d4ff28eb08-bun

Copilot

Pull Request Overview

This PR implements Progressive Override functionality for GraphQL federation, allowing dynamic field resolution control based on labels. The feature supports both percentage-based automatic overrides (using percent(x) syntax) and custom handler functions that evaluate labels against context.

Key changes:

Added progressiveOverride configuration option that accepts a handler function to evaluate override labels
Implemented override logic in delegation planning and field filtering stages
Built-in support for percent(x) syntax for percentage-based progressive rollouts

Reviewed Changes

Copilot reviewed 21 out of 22 changed files in this pull request and generated 2 comments.

Show a summary per file

File	Description
packages/runtime/src/types.ts	Added `progressiveOverride` configuration option to gateway config interface
packages/runtime/src/createGatewayRuntime.ts	Wired progressive override handler through to unified graph manager
packages/fusion-runtime/src/unifiedGraphManager.ts	Added handler parameter to unified graph manager options and handler setup
packages/fusion-runtime/src/federation/supergraph.ts	Passed progressive override handler to supergraph configuration
packages/federation/src/utils.ts	Defined handler types and percentage-based possibility handler
packages/federation/src/supergraph.ts	Extracted override metadata from supergraph SDL and configured field-level overrides
packages/delegate/src/types.ts	Added override configuration to merged field config
packages/delegate/src/handleOverrideByDelegation.ts	Created memoized handler for override evaluation
packages/delegate/src/finalizeGatewayRequest.ts	Integrated override handling into field filtering logic
packages/delegate/src/index.ts	Exported override handler for external use
packages/stitch/src/createDelegationPlanBuilder.ts	Integrated override logic into delegation planning and subschema selection
packages/stitch/src/getFieldsNotInSubschema.ts	Added override checks when determining unavailable fields
packages/federation/tests/progressive-override.test.ts	Added comprehensive test coverage for progressive override scenarios
packages/federation/tests/getStitchedSchemaFromLocalSchemas.ts	Extended test helper to support progressive override handler
e2e/progressive-override/*	Added end-to-end tests with sample services demonstrating the feature
.changeset/cool-wolves-sort.md	Documented the minor version change for affected packages

_{Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.}

packages/stitch/src/createDelegationPlanBuilder.ts

packages/federation/src/supergraph.ts

theguild-bot · 2025-10-24T11:54:32Z

🚀 Snapshot Release (Binary for `Windows-X64`)

The latest changes of this PR are available for download (based on the declared changesets).

n1ru4l · 2025-10-24T13:35:19Z

.changeset/cool-wolves-sort.md

+'@graphql-tools/stitch': minor
+---
+
+Progressive Override Implementation


This changeset could show an actual example and link to documentation

kamilkisiela · 2025-10-24T14:36:35Z

packages/federation/src/supergraph.ts

+
+          const label = fieldInfo.label;
+          // Extract 10 from percent(10) for example
+          const percentRegexp = /^percent\((\d+)\)$/;


\d+ won’t pass floats

ardatan force-pushed the progressive-override branch 3 times, most recently from 2b2bee3 to ce28f67 Compare October 24, 2025 11:37

kamilkisiela reviewed Oct 24, 2025

View reviewed changes

ardatan marked this pull request as ready for review October 24, 2025 11:52

Copilot AI review requested due to automatic review settings October 24, 2025 11:52

Copilot AI reviewed Oct 24, 2025

View reviewed changes

packages/stitch/src/createDelegationPlanBuilder.ts Show resolved Hide resolved

packages/federation/src/supergraph.ts Show resolved Hide resolved

ardatan mentioned this pull request Oct 24, 2025

docs(gateway): progressive override graphql-hive/console#7168

Open

ardatan requested a review from enisdenjo October 24, 2025 12:43

n1ru4l reviewed Oct 24, 2025

View reviewed changes

ardatan force-pushed the progressive-override branch from ce96a6c to 2cd24ac Compare October 24, 2025 14:06

kamilkisiela reviewed Oct 24, 2025

View reviewed changes

ardatan and others added 10 commits October 24, 2025 17:50

Progressive Override

ee3ed64

Fix percent regexp

6df4e2f

Fix build

1c84026

..

a91b55b

Refactor

624061e

More

2b44757

Update changeset

25fd5ef

chore(dependencies): updated changesets for modified dependencies

b884c67

chore(dependencies): updated changesets for modified dependencies

4878e72

Support floats in percentage

da543f7

ardatan and others added 2 commits October 24, 2025 17:50

More checks for utilities

5da5df6

chore(dependencies): updated changesets for modified dependencies

f15ea4b

ardatan force-pushed the progressive-override branch from c993180 to f15ea4b Compare October 24, 2025 14:50

github-actions bot and others added 3 commits October 24, 2025 14:51

chore(dependencies): updated changesets for modified dependencies

290be45

..

65e41e6

Fix for Jest

55039db

Progressive Override #1624

Are you sure you want to change the base?

Progressive Override #1624

Uh oh!

Conversation

ardatan commented Oct 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

kamilkisiela Oct 24, 2025

Choose a reason for hiding this comment

Uh oh!

ardatan Oct 24, 2025

Choose a reason for hiding this comment

Uh oh!

kamilkisiela Oct 24, 2025

Choose a reason for hiding this comment

Uh oh!

ardatan Oct 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

theguild-bot commented Oct 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🚀 Snapshot Release (alpha)

Uh oh!

theguild-bot commented Oct 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🚀 Snapshot Release (Binary for macOS-ARM64)

Uh oh!

theguild-bot commented Oct 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🚀 Snapshot Release (Binary for Linux-ARM64)

Uh oh!

theguild-bot commented Oct 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🚀 Snapshot Release (Binary for Linux-X64)

Uh oh!

theguild-bot commented Oct 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🚀 Snapshot Release (Binary for macOS-X64)

Uh oh!

theguild-bot commented Oct 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🚀 Snapshot Release (Node Docker Image)

Uh oh!

theguild-bot commented Oct 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🚀 Snapshot Release (Bun Docker Image)

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull Request Overview

Reviewed Changes

Uh oh!

Uh oh!

Uh oh!

theguild-bot commented Oct 24, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🚀 Snapshot Release (Binary for Windows-X64)

Uh oh!

n1ru4l Oct 24, 2025

Choose a reason for hiding this comment

Uh oh!

ardatan Oct 24, 2025

Choose a reason for hiding this comment

Uh oh!

kamilkisiela Oct 24, 2025

Choose a reason for hiding this comment

Uh oh!

ardatan Oct 24, 2025

Choose a reason for hiding this comment

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

4 participants

ardatan commented Oct 24, 2025 •

edited

Loading

ardatan Oct 24, 2025 •

edited

Loading

theguild-bot commented Oct 24, 2025 •

edited

Loading

🚀 Snapshot Release (`alpha`)

theguild-bot commented Oct 24, 2025 •

edited

Loading

🚀 Snapshot Release (Binary for `macOS-ARM64`)

theguild-bot commented Oct 24, 2025 •

edited

Loading

🚀 Snapshot Release (Binary for `Linux-ARM64`)

theguild-bot commented Oct 24, 2025 •

edited

Loading

🚀 Snapshot Release (Binary for `Linux-X64`)

theguild-bot commented Oct 24, 2025 •

edited

Loading

🚀 Snapshot Release (Binary for `macOS-X64`)

theguild-bot commented Oct 24, 2025 •

edited

Loading

theguild-bot commented Oct 24, 2025 •

edited

Loading

theguild-bot commented Oct 24, 2025 •

edited

Loading

🚀 Snapshot Release (Binary for `Windows-X64`)