Runtime for GraphQL Mesh Fusion Supergraph
A fully open-source MIT-licensed GraphQL API gateway that can act as a GraphQL federation Gateway or a Proxy Gateway for any GraphQL services.
It can be run as a standalone binary, a Docker Image, or as a JavaScript package (e.g. within Node.js, Bun, Deno, Google Cloud Functions, Azure Functions or Cloudflare Workers)
#1245 29f537f Thanks @enisdenjo! - dependencies updates:
graphql-hive@graphql-mesh/utils@^0.104.5 ↗︎ (from ^0.104.2, in dependencies)#1258 3d24beb Thanks @dependabot! - dependencies updates:
@graphql-mesh/types@^0.104.5 ↗︎ (from ^0.104.0, in dependencies)Updated dependencies [3d24beb]:
#1156 fb74009 Thanks @dependabot! - dependencies updates:
graphql-yoga@^5.13.5 ↗︎ (from ^5.13.4, in dependencies)Updated dependencies [54beb7a, 4a80de1, 85d7c95, 511ba36, dca6529]:
88c9369 Thanks @ardatan! - Handle serving subgraphs when;Query@key directive to a type but without a resolverfaffc17, 0512be3]:2dc5fd8 Thanks @enisdenjo! - Provide non-GraphQL upstream service responses to the retry mechanism configuratione6dfbcd Thanks @enisdenjo! - Lazy print GraphQL schema for logger#1015 9a120c8 Thanks @ardatan! - dependencies updates:
graphql-yoga@^5.13.3 ↗︎ (from ^5.13.2, in dependencies)#1045 da47a0e Thanks @enisdenjo! - dependencies updates:
graphql-yoga@^5.13.4 ↗︎ (from ^5.13.3, in dependencies)#1045 da47a0e Thanks @enisdenjo! - Update graphql-yoga and whatwg-node packages
In light of https://github.com/ardatan/whatwg-node/pull/2305. Please upgrade as soon as possible!
Updated dependencies [da47a0e, da47a0e, 4cf75cb]:
#946 7d771d8 Thanks @ardatan! - dependencies updates:
@graphql-mesh/utils@^0.104.2 ↗︎ (from ^0.104.1, in dependencies)#950 c7ea2c5 Thanks @kroupacz! - Errors should not be swallowed when it is thrown from the shared root
#946 7d771d8 Thanks @ardatan! - Fail when the fetcher returns an empty result. Previously even if fetcher returns undefined, the runtime was trying to handle the result then fails with a cryptic error
Updated dependencies [7d771d8, 7d771d8, c7ea2c5, 0af3485]:
a374bfc]:ab96392 Thanks @enisdenjo! - Revert accidental OpenTelemetry potential breaking changes#532 4e33933 Thanks @EmrysMyrddin! - dependencies updates:
@whatwg-node/promise-helpers@^1.3.0 ↗︎ (from ^1.2.5, in dependencies)graphql-yoga@^5.13.2 ↗︎ (from ^5.13.1, in dependencies)#919 3003ae2 Thanks @ardatan! - Improve disposal and polling cleanup
Updated dependencies [c9cd206, 4e33933, 4e33933, 4e33933, 4e33933, 4e33933, 7b86c09]:
#862 278618a Thanks @ardatan! - dependencies updates:
@whatwg-node/promise-helpers@^1.2.5 ↗︎ (from ^1.0.0, in dependencies)Updated dependencies [278618a, 278618a, 278618a, 278618a, 278618a]:
115a1f1 Thanks @ardatan! - When the schema is reloaded during a query execution, retry the request instead of throwing a reload event error#706 e393337 Thanks @EmrysMyrddin! - dependencies updates:
@envelop/core@^5.2.3 ↗︎ (from ^5.1.0, in dependencies)@graphql-mesh/utils@^0.104.1 ↗︎ (from ^0.104.0, in dependencies)graphql-yoga@^5.13.1 ↗︎ (from ^5.12.0, in dependencies)@envelop/instrumentation@^1.0.0 ↗︎ (to dependencies)#726 6334b2e Thanks @ardatan! - dependencies updates:
@whatwg-node/promise-helpers@^1.0.0 ↗︎ (to dependencies)#727 c54a080 Thanks @renovate! - dependencies updates:
@whatwg-node/disposablestack@^0.0.6 ↗︎ (from ^0.0.5, in dependencies)#772 002fc95 Thanks @renovate! - dependencies updates:
constant-case@^3 ↗︎ (from dependencies)#775 33f7dfd Thanks @renovate! - dependencies updates:
@graphql-mesh/types@^0.104.0 ↗︎ (from ^0.103.18, in dependencies)@graphql-mesh/utils@^0.104.0 ↗︎ (from ^0.103.18, in dependencies)#800 0451e82 Thanks @EmrysMyrddin! - Handle polling correctly when a transport executor has an async disposal process
Updated dependencies [e393337, 33f7dfd, 6334b2e, 6334b2e, 6334b2e, c54a080, 6334b2e, 6334b2e, 9c2f323, 2a54e85]:
#696 a289faa Thanks @ardatan! - dependencies updates:
@envelop/core@^5.1.0 ↗︎ (from ^5.0.3, in dependencies)@graphql-mesh/cross-helpers@^0.4.10 ↗︎ (from ^0.4.9, in dependencies)@graphql-mesh/types@^0.103.18 ↗︎ (from ^0.103.6, in dependencies)@graphql-mesh/utils@^0.103.18 ↗︎ (from ^0.103.6, in dependencies)graphql-yoga@^5.12.0 ↗︎ (from ^5.10.11, in dependencies)Updated dependencies [a289faa, a289faa]:
2318393]:#605 e5d77f3 Thanks @ardatan! - Extract subgraph execution batching logic outside, so batching is handled by the Gateway not Stitching
BREAKING; UnifiedGraphHandlerOpts no longer takes batch option, it is handled by the runtime itself
#605 e5d77f3 Thanks @ardatan! - dependencies updates:
@graphql-tools/batch-execute@workspace:^ ↗︎ (to dependencies)#620 d72209a Thanks @renovate! - dependencies updates:
@graphql-tools/utils@^10.8.1 ↗︎ (from ^10.7.0, in dependencies)#642 30e41a6 Thanks @ardatan! - New JSON-based logger
By default, it prints pretty still to the console unless NODE_ENV is production.
For JSON output, set the LOG_FORMAT environment variable to json.
Updated dependencies [d72209a, d72209a, d72209a, d72209a, d72209a, d72209a, d72209a, 7146f8d, 7146f8d]:
#590 203172c Thanks @ardatan! - Refactor to make it easier to replace the supergraph execution
Updated dependencies [8c80ac9]:
#538 aab5441 Thanks @renovate! - dependencies updates:
graphql-yoga@^5.10.11 ↗︎ (from ^5.10.6, in dependencies)Updated dependencies [b52c9ba, 9144222, b0bc26b]:
18682e6, e9f78cd]:#420 14152f7 Thanks @ardatan! - dependencies updates:
@envelop/core@^5.0.3 ↗︎ (from ^5.0.1, in dependencies)#420 14152f7 Thanks @ardatan! - - In case of schema reload, throw SCHEMA_RELOAD error while recreating the transports and executors
SHUTTING_DOWN error while cleaning the transports and executors upPreviously, these errors are only thrown for subscriptions not it is thrown in other type of operations as well. And previously the thrown errors during these two cleanup and restart process were cryptic, now the mentioned two errors above are thrown with more clear messages
#420 14152f7 Thanks @ardatan! - Leave the supergraph configuration handling logic to fusion-runtime package so it can compare bare read supergraph sdl directly inside unified graph manager to decide if the supergraph has changed.
Updated dependencies [14152f7, a625269, a625269, 14152f7]:
0591aa9]:3571399]:55eb1b4, 55eb1b4]:#373 e606975 Thanks @ardatan! - dependencies updates:
@graphql-tools/executor@^1.3.10 ↗︎ (from ^1.3.6, in dependencies)@graphql-tools/utils@^10.7.0 ↗︎ (from ^10.6.2, in dependencies)#367 15975c2 Thanks @ardatan! - Fix the combination of upstreamRetry and upstreamTimeout together
When you use upstreamRetry and upstreamTimeout together, the upstreamRetry wasn't applied properly when the request is timed out with upstreamTimeout.
Updated dependencies [e606975, e606975, e606975, e606975, e606975, e606975, 15975c2]:
#357 8b64103 Thanks @ardatan! - Fix the bug on setting the default polling interval to 10 seconds
So by default, the gateway will poll the schema every 10 seconds, and update the schema if it has changed.
This PR also contains improvements on logging about polling
#333 0d81307 Thanks @renovate! - dependencies updates:
graphql-yoga@^5.10.6 ↗︎ (from ^5.10.4, in dependencies)Updated dependencies [0d81307]:
23b8987, 23b8987]:#291 34d1224 Thanks @ardatan! - dependencies updates:
@graphql-mesh/cross-helpers@^0.4.9 ↗︎ (from ^0.4.8, in dependencies)@graphql-mesh/types@^0.103.6 ↗︎ (from ^0.103.4, in dependencies)@graphql-mesh/utils@^0.103.6 ↗︎ (from ^0.103.4, in dependencies)@graphql-tools/utils@^10.6.2 ↗︎ (from ^10.6.0, in dependencies)graphql-yoga@^5.10.4 ↗︎ (from ^5.10.3, in dependencies)tslib@^2.8.1 ↗︎ (from ^2.4.0, in dependencies)Updated dependencies [34d1224, 34d1224, 34d1224, 34d1224, 34d1224, 34d1224]:
#286 ed9e205 Thanks @renovate! - dependencies updates:
@graphql-mesh/store@^0.103.4 ↗︎ (from dependencies)#284 f2e0ae2 Thanks @ardatan! - Do not use require explicitly
#284 f2e0ae2 Thanks @ardatan! - Avoid `require` but use `globalThis.require` instead
#274 3f1a0fa Thanks @ardatan! - Improve `import` and `require` interop
Updated dependencies []:
#269 cdca511 Thanks @ardatan! - dependencies updates:
@graphql-tools/executor@^1.3.6 ↗︎ (from ^1.3.2, in dependencies)@graphql-tools/merge@^9.0.12 ↗︎ (from ^9.0.8, in dependencies)Updated dependencies [cdca511, 7df2215, cdca511, cdca511, cdca511, cdca511, cdca511]:
9ce705c]:#248 248c8a6 Thanks @enisdenjo! - Log Unified Graph caching errors
#247 76642d8 Thanks @ardatan! - Handle `@resolveTo` for interfaces correctly
#248 248c8a6 Thanks @enisdenjo! - Log caching of unified graph
#248 248c8a6 Thanks @enisdenjo! - Increase default TTL for caching Unified Graph to 60s
Updated dependencies [76642d8]:
#234 ba7e585 Thanks @ardatan! - Drop `@hidden` support in favor of `@inaccessible`
Updated dependencies [ba7e585]:
7ca0ff3]:#205 2e0add3 Thanks @ardatan! - dependencies updates:
graphql-yoga@^5.10.3 ↗︎ (to dependencies)#208 baf896d Thanks @ardatan! - dependencies updates:
graphql-yoga@^5.7.0 ↗︎ (from dependencies)Updated dependencies [2e0add3, 2e0add3]:
#164 310613d Thanks @ardatan! - dependencies updates:
@graphql-tools/utils@^10.6.0 ↗︎ (from ^10.5.6, in dependencies)#180 9438e21 Thanks @ardatan! - dependencies updates:
@graphql-mesh/store@^0.103.4 ↗︎ (from ^0.103.0, in dependencies)@graphql-mesh/types@^0.103.4 ↗︎ (from ^0.103.0, in dependencies)@graphql-mesh/utils@^0.103.4 ↗︎ (from ^0.103.1, in dependencies)@graphql-mesh/runtime@^0.105.0 ↗︎ (from dependencies)#185 f0b6921 Thanks @ardatan! - dependencies updates:
@graphql-mesh/store@^0.103.4 ↗︎ (from ^0.103.0, in dependencies)@graphql-mesh/types@^0.103.4 ↗︎ (from ^0.103.0, in dependencies)@graphql-mesh/utils@^0.103.4 ↗︎ (from ^0.103.1, in dependencies)@graphql-mesh/runtime@^0.105.0 ↗︎ (from dependencies)#98 697308d Thanks @ardatan! - dependencies updates:
@graphql-mesh/cross-helpers@^0.4.8 ↗︎ (from ^0.4.7, in dependencies)@graphql-mesh/utils@^0.103.1 ↗︎ (from ^0.103.0, in dependencies)#180 9438e21 Thanks @ardatan! - Use new explicit resource management internally
Updated dependencies [310613d, 9438e21, f0b6921, 310613d, 310613d, f0b6921, f71366d, 310613d, f0b6921, f71366d, 310613d, 310613d, f0b6921, f71366d, b534288]:
725d5b7]:#148 f32cb2a Thanks @ardatan! - dependencies updates:
@graphql-mesh/runtime@^0.105.0 ↗︎ (from ^0.104.1, in dependencies)@graphql-mesh/store@^0.103.0 ↗︎ (from ^0.102.12, in dependencies)@graphql-mesh/types@^0.103.0 ↗︎ (from ^0.102.12, in dependencies)@graphql-mesh/utils@^0.103.0 ↗︎ (from ^0.102.12, in dependencies)#150 c0e189a Thanks @enisdenjo! - dependencies updates:
@graphql-mesh/runtime@^0.105.0 ↗︎ (from ^0.104.1, in dependencies)@graphql-mesh/store@^0.103.0 ↗︎ (from ^0.102.12, in dependencies)@graphql-mesh/types@^0.103.0 ↗︎ (from ^0.102.12, in dependencies)@graphql-mesh/utils@^0.103.0 ↗︎ (from ^0.102.12, in dependencies)#148 f32cb2a Thanks @ardatan! - Introduce `onDelegationPlan` and `onDelegationStageExecuteDone` hooks
Updated dependencies [f32cb2a, c0e189a, f32cb2a]:
#108 86c7ac1 Thanks @ardatan! - dependencies updates:
@graphql-mesh/transport-common@workspace:^ ↗︎ (from ^0.7.13, in dependencies)@graphql-mesh/store@^0.102.12 ↗︎ (to dependencies)constant-case@^3 ↗︎ (to dependencies)change-case@^4.1.2 ↗︎ (from dependencies)#118 73c621d Thanks @ardatan! - dependencies updates:
@graphql-tools/delegate@workspace:^ ↗︎ (from ^10.0.28, in dependencies)@graphql-tools/federation@workspace:^ ↗︎ (from ^2.2.21, in dependencies)@graphql-tools/stitch@workspace:^ ↗︎ (from ^9.2.17, in dependencies)@graphql-tools/stitching-directives@workspace:^ ↗︎ (from ^3.1.9, in dependencies)@graphql-tools/wrap@workspace:^ ↗︎ (from ^10.0.12, in dependencies)#110 b84b8f9 Thanks @ardatan! - Do not override existing merge configuration
c95d25e Thanks @enisdenjo! - onError and onEnd callbacks from onSubgraphExecute are invoked only once regardless of how many times throw/return was called on the iterator
Updated dependencies [73c621d, 73c621d, 19bc6a4]:
eee53b9,
eee53b9]:ac82d44]:de41fc2
Thanks @ardatan! - dependencies updates:@graphql-tools/delegate@^10.0.28 ↗︎
(from ^10.0.27, in dependencies)@graphql-tools/federation@^2.2.21 ↗︎
(from ^2.2.19, in dependencies)@graphql-tools/stitch@^9.2.17 ↗︎
(from ^9.2.15, in dependencies)@graphql-tools/stitching-directives@^3.1.9 ↗︎
(from ^3.1.8, in dependencies)@graphql-tools/wrap@^10.0.12 ↗︎
(from ^10.0.11, in dependencies)de41fc2,
de41fc2,
de41fc2,
de41fc2]:dc54d58
Thanks @EmrysMyrddin! - WebSocket connections are now cached
against the whole connectionParams object and forwarded headers. The fixes WebSocket
connection being reused wrongly when connectionParams.token is stable while other fields are
changing.997b81c
Thanks @ardatan! - dependencies updates:@graphql-tools/delegate@^10.0.27 ↗︎
(from ^10.0.26, in dependencies)@graphql-tools/federation@^2.2.19 ↗︎
(from ^2.2.17, in dependencies)@graphql-tools/stitching-directives@^3.1.8 ↗︎
(from ^3.1.7, in dependencies)@graphql-tools/wrap@^10.0.11 ↗︎
(from ^10.0.10, in dependencies)997b81c,
997b81c,
997b81c,
997b81c]:#7816
fad4d27
Thanks @ardatan! - dependencies updates:
@graphql-tools/merge@^9.0.8 ↗︎
(to dependencies)#7816
fad4d27
Thanks @ardatan! - Fix subscription fields fed by webhooks and
defined in `additionalTypeDefs` with `@resolveTo`
Updated dependencies
[fad4d27]:
f7ad933
Thanks @ardatan! - dependencies updates:@graphql-tools/federation@^2.2.17 ↗︎
(from ^2.2.16, in dependencies)518c42c
Thanks @ardatan! - dependencies updates:@graphql-tools/delegate@^10.0.26 ↗︎
(from ^10.0.23, in dependencies)@graphql-tools/federation@^2.2.16 ↗︎
(from ^2.2.12, in dependencies)@graphql-tools/stitch@^9.2.15 ↗︎
(from ^9.2.12, in dependencies)@graphql-tools/stitching-directives@^3.1.7 ↗︎
(from ^3.1.4, in dependencies)@graphql-tools/wrap@^10.0.10 ↗︎
(from ^10.0.7, in dependencies)518c42c,
359da22,
518c42c,
518c42c,
518c42c]:50bf472
Thanks @ardatan! - dependencies updates:@graphql-tools/delegate@^10.0.23 ↗︎
(from ^10.0.21, in dependencies)@graphql-tools/executor@^1.3.2 ↗︎
(from ^1.3.1, in dependencies)@graphql-tools/federation@^2.2.12 ↗︎
(from ^2.2.10, in dependencies)@graphql-tools/stitch@^9.2.12 ↗︎
(from ^9.2.10, in dependencies)@graphql-tools/stitching-directives@^3.1.4 ↗︎
(from ^3.1.2, in dependencies)@graphql-tools/utils@^10.5.5 ↗︎
(from ^10.5.3, in dependencies)@graphql-tools/wrap@^10.0.7 ↗︎
(from ^10.0.5, in dependencies)50bf472,
50bf472,
50bf472,
50bf472,
50bf472]:bf588d3]:01f6ad9
Thanks @enisdenjo! - Use source name when hoisting fields#7676
adc3293
Thanks @ardatan! - If the target hoisted field is a new field name
that doesn't exist, create that field and keep the existing one;
createHoistFieldTransform({
mapping: [
{
typeName: 'Query',
pathConfig: ['users', 'results'],
newFieldName: 'usersResults',
},
],
});
type Query {
users(limit: Int!, page: Int): UserSearchResult # Keep this
+ usersResults(limit: Int!, page: Int): [User!]! # Add a new one
}
scalar _HoistConfig
type UserSearchResult {
page: Int!
}
type User {
id: ID!
name: String!
}
#7668
547cbb7
Thanks @ardatan! - dependencies updates:
@graphql-tools/federation@^2.2.10 ↗︎
(from ^2.2.9, in dependencies)#7668
547cbb7
Thanks @ardatan! - Fix additional type definitions without shared
types
ccadfab
Thanks @enisdenjo! - Header Propagation7df3815]:#7595
3bf14b3
Thanks @renovate! - dependencies updates:
@whatwg-node/disposablestack@^0.0.4 ↗︎
(from ^0.0.3, in dependencies)#7596
b7f6ebf
Thanks @enisdenjo! - dependencies updates:
@whatwg-node/disposablestack@^0.0.5 ↗︎
(from ^0.0.4, in dependencies)#7597
0a3e52c
Thanks @ardatan! - dependencies updates:
@whatwg-node/disposablestack@^0.0.5 ↗︎
(from ^0.0.4, in dependencies)3bf14b3,
b7f6ebf,
0a3e52c]:5146df0]:edbc074
Thanks @ardatan! - dependencies updates:@graphql-tools/delegate@^10.0.21 ↗︎
(from ^10.0.20, in dependencies)edbc074,
edbc074,
edbc074,
edbc074]:#7572
14ec31f
Thanks @ardatan! - dependencies updates:
@graphql-tools/delegate@^10.0.20 ↗︎
(from ^10.0.19, in dependencies)@graphql-tools/federation@^2.2.10 ↗︎
(from ^2.2.8, in dependencies)#7569
e9d73b7
Thanks @ardatan! - If the first poll fails, keep polling but fail on
requests If any poll fails in somewhere, keep polling but keep using the last successful
supergraph
So if the CDN is down at some point, the gateway will keep polling the supergraph, but will keep using the last successful supergraph. This is useful for cases where the CDN is down, but the supergraph is still available.
Updated dependencies
[14ec31f,
14ec31f,
14ec31f,
14ec31f]:
5d95aad
Thanks @renovate! - dependencies updates:@whatwg-node/disposablestack@^0.0.3 ↗︎
(from ^0.0.2, in dependencies)5d95aad]:#7553
e49a7e6
Thanks @renovate! - dependencies updates:
@whatwg-node/disposablestack@^0.0.2 ↗︎
(from ^0.0.1, in dependencies)#7553
e49a7e6
Thanks @renovate! - Fix transport cleanup logic
Updated dependencies
[e49a7e6,
60bfc22]:
db41f96]:eeab8fe
Thanks @ardatan! - dependencies updates:graphql-yoga@^5.7.0 ↗︎ (from ^5.6.0,
in dependencies)b0cdc83
Thanks @enisdenjo! - dependencies updates:@graphql-mesh/transport-common@^0.6.1 ↗︎
(from ^0.6.0, in dependencies)#7517
e06ac0d
Thanks @ardatan! - Accept imported modules as transports and find
subgraph executor
#7513
09ad884
Thanks @enisdenjo! - Bubble module import errors when module is
installed
#7516
67e1062
Thanks @enisdenjo! - Transport's kind doesn't need to be typed
Updated dependencies
[67e1062]:
#7501
83b8cdc
Thanks @enisdenjo! - Polling interval option has been renamed to
pollingInterval
import { UnifiedGraphManager } from '@graphql-mesh/fusion-runtime';
const mngr = new UnifiedGraphManager({
- polling: 10_000
+ pollingInterval: 10_000
});
#7497
d784488
Thanks @ardatan! - dependencies updates:
@graphql-tools/utils@^10.5.2 ↗︎
(from ^10.3.4, in dependencies)#7512
190e9ec
Thanks @ardatan! - dependencies updates:
@graphql-tools/delegate@^10.0.19 ↗︎
(from ^10.0.18, in dependencies)@graphql-tools/federation@^2.2.8 ↗︎
(from ^2.2.5, in dependencies)@graphql-tools/utils@^10.5.3 ↗︎
(from ^10.5.2, in dependencies)d784488,
190e9ec,
d784488,
190e9ec,
d784488,
190e9ec,
d784488,
190e9ec,
d784488,
190e9ec,
d784488]:0c82de5
Thanks @enisdenjo! - Control subgraph execution batching in
UnifiedGraphManager with batch option#7477
c06a048
Thanks @ardatan! - dependencies updates:
@graphql-tools/delegate@^10.0.18 ↗︎
(from ^10.0.17, in dependencies)@graphql-tools/executor@^1.3.1 ↗︎
(from ^1.3.0, in dependencies)@graphql-tools/utils@^10.3.4 ↗︎
(from ^10.2.3, in dependencies)#7482
d5a4cd4
Thanks @ardatan! - dependencies updates:
@graphql-tools/federation@^2.2.5 ↗︎
(from ^2.2.4, in dependencies)#7460
0c82de5
Thanks @enisdenjo! - Batching subgraph requests independant of the
JEST environment variable
Updated dependencies
[c06a048,
c06a048,
c06a048,
c06a048,
c06a048,
a324c5e,
4d1eb28,
a324c5e]:
a1bfc49]:#7447
6c67e77
Thanks @ardatan! - dependencies updates:
@graphql-tools/delegate@^10.0.17 ↗︎
(from ^10.0.16, in dependencies)@graphql-tools/federation@^2.2.4 ↗︎
(from ^2.2.3, in dependencies)#7447
6c67e77
Thanks @ardatan! - Improvements on schema loading handling
Updated dependencies
[6c67e77,
6c67e77,
6c67e77,
6c67e77,
6c67e77,
6c67e77]:
7cd4d35
Thanks @ardatan! - dependencies updates:@graphql-tools/federation@^2.2.3 ↗︎
(from ^2.2.1, in dependencies)1905f53
Thanks @ardatan! - dependencies updates:@graphql-tools/stitching-directives@^3.1.2 ↗︎
(from ^3.0.2, in dependencies)f5214eb]:33c23e8
Thanks @ardatan! - dependencies updates:@whatwg-node/disposablestack@^0.0.1 ↗︎
(to dependencies)disposablestack@^1.1.6 ↗︎ (from
dependencies)33c23e8]:#7343
597e790
Thanks @ardatan! - More verbose debug logs for HTTP fetch calls and
subgraph requests
Updated dependencies
[597e790,
597e790]:
5e5dec5,
5e5dec5]:f47c900
Thanks @dotansimha! - Pass context type from OnSubgraphExecute
to ExecutionRequest#7351
9f6624e
Thanks @ardatan! - dependencies updates:
@graphql-tools/federation@^2.2.0 ↗︎
(from ^2.1.2, in dependencies)@graphql-mesh/cross-helpers@^0.4.4 ↗︎
(to dependencies)#7352
4bc495c
Thanks @ardatan! - dependencies updates:
@graphql-tools/delegate@^10.0.16 ↗︎
(from ^10.0.14, in dependencies)@graphql-tools/executor@^1.3.0 ↗︎
(from ^1.2.8, in dependencies)@graphql-tools/federation@^2.2.1 ↗︎
(from ^2.2.0, in dependencies)#7341
29dc043
Thanks @dr3! - Fix the bug when field name is renamed together with the
argument
#7294
345a814
Thanks @ardatan! - Ability to manipulate transport entry through
transportEntries.
For example, you can add extra headers to a subgraph
transportEntries: {
products: {
// This adds extra headers to the subgraph configuration
headers: [
// This forwards `authorization` from the upstream to downstream
['authorization', '{context.headers.authorization}'],
// Or some static value
['x-extra', process.env.SOME_THING],
];
}
}
Updated dependencies
[4bc495c,
4bc495c,
4bc495c,
4bc495c,
345a814]:
#7316
7800514
Thanks @enisdenjo! - dependencies updates:
@graphql-tools/delegate@^10.0.14 ↗︎
(from ^10.0.12, in dependencies)@graphql-tools/federation@^2.1.2 ↗︎
(from ^2.1.1, in dependencies)#7253
2b8e52f
Thanks @ardatan! - Fix the bug; When a non-nullable field is added
through additionalTypeDefs in the compose config, then the gateway fails to resolve it even if a
resolver defined in additionalResolvers;
export const composeConfig = defineComposeConfig({
subgraphs: [
{
sourceHandler: loadOpenAPISubgraph('Wiki', {
source:
'https://api.apis.guru/v2/specs/wikimedia.org/1.0.0/swagger.yaml',
endpoint: 'https://wikimedia.org/api/rest_v1',
}),
},
],
additionalTypeDefs: /* GraphQL */ `
extend type pageview_project {
banana: String
apple: String!
}
`,
});
export const serveConfig = defineServeConfig({
additionalResolvers: {
pageview_project: {
banana() {
return '🍌';
},
apple() {
return '🍎'; // This is ignored
},
},
},
});
#7266
26deb92
Thanks @ardatan! - Fix transformations on enum values
Updated dependencies
[7800514,
7800514,
7800514,
7800514]:
eefbfbe
Thanks @ardatan! - Cleanup created transport executors per schema
change Previously they were cleaned up only on server close, which could lead to memory leaks in
case of schema changes.69e6eb5,
ededa2c,
a8e3f00,
a8e3f00,
69e6eb5,
69e6eb5]:#7183
8a04cf7
Thanks @ardatan! - dependencies updates:
graphql-yoga@^5.6.0 ↗︎ (from ^5.3.0,
in dependencies)#7185
0d916a4
Thanks @ardatan! - dependencies updates:
@graphql-tools/delegate@^10.0.12 ↗︎
(from ^10.0.11, in dependencies)@graphql-tools/executor@^1.2.8 ↗︎
(from ^1.2.6, in dependencies)@graphql-tools/federation@^2.1.1 ↗︎
(from ^2.0.0, in dependencies)@graphql-tools/stitch@^9.2.10 ↗︎
(from ^9.2.9, in dependencies)@graphql-tools/utils@^10.2.3 ↗︎
(from ^10.2.1, in dependencies)0d916a4,
0d916a4,
0d916a4,
0d916a4,
8a04cf7]:#7145
7544594
Thanks @Author, @User! - New Federation
Composition Approach for the new Mesh v1 alpha; (If you are using Mesh v0 legacy, ignore this
changelog)
Now Mesh Compose produces a superset of Federated Supergraph.
fusiongraph@theguild/federation-composition package__resolveReference, we use @merge directive to mark a root field as an
entity resolver for Federation@source directive to consume transforms on the subgraph execution (field
renames etc)@resolveTo directive to consume additional stitched resolvers@transport directive to choose and configure a specific transport for subgraphsQuery
for example directives on unions, schema definitions, enum values etc and then
@extraUnionDirective added with missing directives for unions then on the runtime these
directives are added back to the union for the subgraph execution of the transports.Basically Mesh Compose uses Federation spec for composition, validation and runtime BUT the output
is a superset with these additional directives imported via @composeDirective;
@merge (Taken from Stitching Directives) If a custom entity resolver is defined for a root
field like below, the gateway will pick it up as an entity resolver;type Query {
fooById(id: ID!): Foo @merge(keyField: 'id', keyArg: 'id', subgraph: Foo)
}
@resolveTo (Taken from v0) This allows to delegate to a field in any subgraph just like Schema
Extensions in old Schema Stitching approach; extend type Book {
@resolveTo(
sourceName: "authors"
sourceTypeName: "Query"
sourceFieldName: "authors"
keyField: "authorId"
keysArg: "ids"
)
}
@source Taken from Fusion This allows us to know how the original definition is in the
subgraph. If this directive exists, the runtime applies the transforms from Schema Stitching
during the subgraph execution. This directive can exist in arguments, fields, types etc.type Query {
@source(type: "MyUser") # This means `User` is actually `MyUser` in the actual subgraph
}
type User @source(name: "MyUser") {
id: ID
name: String
}
@transport Taken from Fusion This allows us to choose a specific transport (rest, mysql,
graphql-ws, graphql-http etc) for the subgraph execution with some configuration. In the
runtime, the gateway loads the transports and passes the subgraph schema with annotations if
needed to get an executor to execute queries against that subgraph.schema
@transport(
subgraph: "API"
kind: "rest"
location: "http://0.0.0.0:<api_port>"
) {
query: Query
mutation: Mutation
subscription: Subscription
}
@extraSchemaDefinitionDirective By default, it is not possible to add directives from subgraph
to the supergraph but it is possible to do the same thing on types or fields. So we add this
directive to Query for the directives we want to add to the schema. Then the runtime picks
those per subgraph to put the directives back to their original places;type Query @extraSchemaDefinitionDirective(
directives: {transport: [{subgraph: "petstore", kind: "rest", location: "http://0.0.0.0:<petstore_port>/api/v3"}]}
) {
@extraEnumValueDirective and @extraTypeDirective Same for enum values and unions etc that
are not supported by the composition libraryThanks to these directives, subgraphs can be published individually to Hive for example then the supergraph stored there can be handled by Mesh Gateway since the composition is the same. All the additions etc are done on the subgraph level. For the Fed gateways except Mesh Serve, subgraphs can be served individually by Mesh Serve again while they are consumed by any gw like Apollo Router Shareable is enabled by default for non-federated subgraphs
Documentation PR has details for users; https://github.com/ardatan/graphql-mesh/pull/7109
Updated dependencies
[f985978,
7544594,
7544594]:
6a99c52]:#7009
b5bf97c
Thanks @ardatan! - dependencies updates:
@envelop/core@^5.0.1 ↗︎ (to
dependencies)@graphql-tools/executor@^1.2.6 ↗︎
(to dependencies)@graphql-tools/federation@^1.1.36 ↗︎
(to dependencies)#7054
88d6232
Thanks @ardatan! - dependencies updates:
@graphql-tools/federation@^2.0.0 ↗︎
(to dependencies)disposablestack@^1.1.6 ↗︎ (to
dependencies)#7009
b5bf97c
Thanks @ardatan! - Implement declarative transforms
#7054
88d6232
Thanks @ardatan! - Use Disposable pattern for plugins and
transports
Updated dependencies
[88d6232,
b5bf97c,
4c75671,
88d6232,
88d6232]:
270679b
Thanks @ardatan! - dependencies updates:@graphql-tools/delegate@^10.0.11 ↗︎
(from ^10.0.10, in dependencies)@graphql-tools/stitch@^9.2.9 ↗︎
(from ^9.2.8, in dependencies)@graphql-tools/utils@^10.2.1 ↗︎
(from ^10.2.0, in dependencies)270679b,
270679b,
270679b,
270679b]:c4d2249]:Updated dependencies
[fb59244]:
d9b5137]:Updated dependencies
[c47b2aa]:
Updated dependencies
[96dd11d]:
6044b7f]:#6779
6399add
Thanks @enisdenjo! - dependencies updates:
@graphql-tools/utils@^10.1.3 ↗︎
(from ^10.1.0, in dependencies)#6872
2fcadce
Thanks @ardatan! - dependencies updates:
@graphql-tools/stitch@^9.2.0 ↗︎
(from ^9.2.3, in dependencies)graphql-yoga@^5.3.0 ↗︎ (from ^5.1.1,
in dependencies)@graphql-mesh/types@^0.97.5 ↗︎
(to dependencies)@graphql-tools/delegate@^10.0.6 ↗︎
(to dependencies)@graphql-tools/stitching-directives@^3.0.2 ↗︎
(to dependencies)@graphql-tools/wrap@^10.0.5 ↗︎
(to dependencies)@graphql-mesh/fusion-execution@^0.0.2 ↗︎
(from dependencies)7881346
Thanks @ardatan! - Bump @graphql-tools/stitch package
Updated dependencies
[2fcadce,
2fcadce,
2fcadce,
2fcadce,
6399add,
666b79c,
6399add]:
afe0cc5]:c008dda]:18e0d49]:e2fb7ed,
e2fb7ed]:ccb80d8]:662a36a
Thanks @enisdenjo! - Change executionRequest in onSubgraphExecute
hook and use one transportKind argument instead of spreading it#6598
35b9cab
Thanks @enisdenjo! - onSubgraphExecute hook can return nothing
Updated dependencies
[92dce67,
70b05a2]:
b7c3631
Thanks @EmrysMyrddin! - dependencies updates:@graphql-tools/utils@^10.1.0 ↗︎
(from ^10.0.8, in dependencies)0f274ef]:7b494d9
Thanks @enisdenjo! - Improve typings and other accompanying
improvements44d40ff
Thanks @enisdenjo! - dependencies updates:@graphql-mesh/runtime@^0.97.6 ↗︎
(to dependencies)@graphql-mesh/utils@^0.96.5 ↗︎
(to dependencies)#6551
7c18a3f
Thanks @enisdenjo! - No omnigraph transports and recommend
graphql-mesh transports
Updated dependencies []: