Roadmap

[theguild-bot]

This page is synced automatically from The Guild's Notion
Notion page URL: https://www.notion.so/Roadmap-2b5d570a188c400eb4eb7269d641e4f5

At The Guild we’ve decided to work as much as we can in public, that’s why we are opening the roadmaps for all of our projects.

The goals for this are:

1. So you will know what we are working on, what we see as a higher priority, and know what to expect from our projects in the future
2. So you can share your opinions and thoughts about what we do and influence our decisions
3. So you can join us and contribute to our efforts!

v1

• OpenAPI Handler overhaul #4278
• Docs Roadmap #4280
• Improve and refactor Build Flow #4283
  • Generate separately types files from mesh build command #4299
• Create less noisy and more descriptive releases that are easy to follow #4281
• Use the new Yoga v3 #4282
• Hive Integration #4826
• Improve the execution pipeline splitting execution and schema generation #4284
• ESM Support #4285
• Better Error Handling #4286
• Dependency Dashboard #2704
• Use same terms in configurations in all handlers as much as possible #4362
• Yarn 2.0 support #2923

v1.x

• Rename artifacts destination folder to not start with dot #5038
• Support fragments as requiredSelectionSet #4361
• Use The Guild’s code standards
• connectionParams are not passed downstream anymore #4040
  • Pass WebSocket connectionParams to downstream also in connectionParams #4305
• Allow including external yaml files in .meshrc.yaml #1412
• additionalResolvers child field arguments aren't passed through to the backend / all fields are requested #1257
• Implementation of Hive store
• gRPC
  • Webhook to gRPC handler #3984
  • grpc: failed to generate schema #4586
  • CSRF protection #3961
  • gRPC unable to generate schema #4388
  • Forward Client RemoteIP #3940
  • Allow FileDescriptorSets in place of individual .proto files #1071
  • Reflection Header grpc-reflection-js #2105
  • Conflict grpc package name and message name #2176
  • Think about changing protobuf.js
    • Forking
    • https://buf.build/blog/connect-web-protobuf-grpc-in-the-browser
      • https://github.com/bufbuild/protobuf-es
      • https://github.com/bufbuild/connect-web
      • https://github.com/bufbuild/connect-web-integration
  • SyntaxError: Named export 'FileDescriptorSet' not found in grpc handler #4316
• New handlers
  • SMDX SDMX source handler #4524
  • JSON LD/RDF JSON-LD / RDF source handler #4523
  • Oracle Oracle Handler #4521
  • Clickhouse Input handler for Clickhouse #4525
  • Presto/trinodb Feature Request | Input Handler for Presto/trinodb.com #4520
  • Apache AGE Apache AGE handler?? Apache AGE is a PostgreSQL Extension that provides graph database functionality #4522
• Transforms improvements
  • Field Argument Type Rewriter Transform #3960
  • TypeResolver of GraphQL interface type is not working #3881
  • Can't override an existing field with an object type #3788
  • Transform-Replace-Field: Leads to null response (clash of user expectation). #3533
  • @graphql-mesh/transform-filter-schema prevents creation of index.d.ts #3523
  • Cache transform should wait until active requests for the same cache key are completed #2994
  • Discussion: replace-field transform #2975
  • Trouble with the transformation Rename with fields start by number #2491
  • Allow configure mode default + support all transforms on all sources #1930
  • returnData does not resolve external values nor errors #1744
  • Renaming fields arguments #1422
  • Allow rename transform to rename multiple types into a single one #1415
  • Provide a way to only expose a set of given tables and/or views out of a DB #1045
  • Adding prefix transforner deactivate caching #1548
  • Naming Convention Transform Breaks Union Type Query #1592
  • Rename & Encapsulate Transforms On GraphQL Handler Break Query #1600
  • Encapsulate on JSON Schema Handler Breaks API Functionality #1711
  • When generating output a schema property is being ignored/skipped #1970
  • Incorrect docs for string interpolation #2004
  • Redis critical failure when using GraphQL field aliases (bug) #2292
  • Transform request body for json-schema #2875
  • Add user-specific hash to cacheKey #3586
  • Configurable renaming function Expose openAPI nameFormatter function. #3939
• Additional Resolvers
  • resolversComposition bug #3224
  • additionalResolvers doesn't work #2868
  • argTypeMap no longer takes custom types #2881
  • Improve doc of additionalResolvers sourceArgs #3115
  • Arguments converted to string on additionalResolvers with requiredSelectionSet #4328
  • Provide request information in resolverComposition #4319
  • Migrating from Declarative to Programmatic additionalResolver #4587
• Type Merging
  • Resolvers Composition plugin doesn't work with GraphQL-like sources. #4202
  • Getting error while trying to extend unified schema #4049
  • selectionSet is not passed to delegateToSchema/batchDelegateToSchema when using GraphQL Handlers #2720
  • Additional resolver doesn't work after mutation #3180
  • Batching between mesh and a gql handler does not work for mutations #3454
  • Apollo Gateway/Federation does not work to graphql-mesh backend service #3471
  • Can we share some code with the following solutions
    • Looks into this library instead of the current one we use to turn services into federated services: https://github.com/nearform/graphql-auto-federate
    • Status of Project? 0xR/graphql-transform-federation#20 (comment)
• Better support for different environments (serverless etc.)
  • IDEA: Investigate Next.js Edge Runtime compatibility #4193
  • Bundle side improvements
    • Smaller bundle size, now GraphQL handler specific stuff is not in the core packages #4124
    • IDEA: Use AJV's standalone compiler to reduce the bundle size for JSON Schema loader #4099
  • Cloudflare Workers
    • The error The script will never generate a response on Cloudflare Workers. #4201
    • Ability to use KV Cache
    • Response cache, rate limiting, proxying, stitching etc on-the-edge!
    • More marketing around that
      • IDEA: Update documentation with new KV Cache support and example #4098
  • Deno support
    • Investigate current state of Deno support #4111
  • Node.js & Windows
    • Make sure we handle paths correctly
      • json-machete:0.9.0 breaks on Windows when loading local files #4094
      • fix(read-file): fix path resolution on Windows #4117
    • Setup CI for Windows tests
      • IDEA: Add tests for Windows #4118
      • Docker containers aren’t supported so we need to figure that out
        • Pulumi can help?
  • Client
    • Add a custom context #2856
  • Mesh not working in Docker desktop #4629
• Declarative Plugin System
  • Documentation needed!
    • Use cases, examples etc
  • What will happen to the existing transforms?
    • IDEA: Deprecate cache and rate limit transforms in favor of response cache and rate limit plugin #4074
  • New Rate Limit plugin
    • https://github.com/Urigo/graphql-mesh/blob/master/packages/plugins/rate-limit/yaml-config.graphql
  • Declarative Response Cache plugin
    • https://github.com/Urigo/graphql-mesh/tree/master/packages/plugins/response-cache
    • Add a way to access context headers in the cache key for caching #1771
    • redis cache issues #1130
  • Declarative Live Query plugin
    • https://www.graphql-mesh.com/docs/guides/live-queries
    • Deep live queries with gateway-to-service persistent connections #4841
  • New Relic
    • Only first request to application is passed with distributed tracing to New Relic #4312
• Configurations improvements
  • Request: Validate meshrc config dynamically instead of from a static json schema #664
  • Change the configuration style to something like we are experimenting in Conductor
  • Type safety in YAML somehow, maybe TypeScript based configuration file
    • So field and type references in transformers might be type safe!
    • Directives can help with more strict enums and so on
  • Directive based configurations
    • New @resolveTo directive
• Improved integration with Hive
  • Registry for artifacts and validation
  • Persisted Operations
    • Can be combined with a declarative JIT plugin
• Type safe delegateToSchema, maybe the query builder inside stitching/additional resolver (This is actually part of stitching) instead of weird incontext SDK
  • Dynamic Query Builder in favor of SDK
• Propagate graphql extensions #4207
• Refactor odata handler #2473
  • Refactor OData handler #2466
  • [OData Handler] Invalid OData URI generation #782
  • [OData Handler] Add default filter param of ID for all queries on collections when talking to Microsoft Graph #787
  • [OData] provide GraphQL schema layouts #903
  • [oData Handler] Count Not Behaving as Expected #944
  • [oData Handler] Implementation of calling an single entity is not correct #3770
  • [oData Handler] Empty response e.g. when updating an entity leads to an error #3771
  • MSGraph Odata query sub objects error #4088
• Feature request: dynamic adding of the service to Mesh #642
• Feature request: specify configName for input when generating TypeScript types #882
• Rewrite SOAP Handler #3137
  • Look into https://github.com/vpulim/node-soap
  • Unable to authenticate to SOAP API #472
  • Error in generating types from valid WSDL's using GraphQL-mesh Soap plugin #4647
• Improvements to GraphiQL
  • having a button to export results from GraphQL to csv or json #3349
  • Headers are not stored in a Graphiql history  #4386
• Mocking
  • Accessing a non existand data from the mockStore complains about the wrong thing #2320
  • Mocking: Resolving a union throws an error #2382
  • Unable to disable Faker #3192
• GraphQL subscriptions are not working #4590
• fix(build): use correct path for relative imports of external modules + bracket notation #2974
• Create a Mesh plugin for IDEs like Insomnia to query REST APIs like GraphQL
• MySQL
  • Mysql Input handler -> No mark columns auto_increment, nullable and with default values as mandatory on generated input schema  #2182
  • mySQL Handler raises error on invalid date-time-string 2016-03-16 06:38:12 #3945
  • [MySQL Handler] Support upsert mutation  #4002
  • Add support for Mariadb or edit MySQL handler to support Mariadb #1619
• [NEW] Transfer schema Transform #3185
• Add additionalResolvers example for passing args to nested fields #779
• K6 Runtime performance tests
• IDEA: Implement Fetch strategies for other possible handlers #4087
• Pass context to fetch in json-schema loader (used in new-openapi handler) #4293
• GQL Mesh Improvements - Summary Issue [trivago feedback] #2782
• {"status":"INTERNAL_SERVER_ERROR","code":9432,"message":"Your session has expired. Please login.","statusCode":500}; #3966
• Resolvers not getting merged #2219
• query returns null instead of value #2311
• "message": "Unexpected error value: { name: \"SyntaxError\", message: \"Unexpected 'I'\", at: 1, text: \"Invalid Query\" }", #3955
• Use Mesh to enable global object identification support #2155
• Argument standardization #2156
• Passing subscription queries to sources does not work #1472
• feat(options) postgraphile: add contextOptions to allow custom jwt claims #3915
• File paths in postgraphile handler is not transformed correctly when building for production. (Breaks production build) #3886
• Support custom jwt claims in postgraphile handler. #3913
• Runtime Package Redesign #861
• Mesh SDK execution fails #1339
• Feature - Mongoose handler does not respect refs, virtual and pre #1351
• Batch Error on Integration w/ Directus.io  #1666
• Better error messages from additionalResolvers #1706
• Feature request: Response pagination #4212
• Review https://github.com/Urigo/graphql-mesh/discussions
• Document stateful mocking and modify the transform configuration #1999
• JSON Schema Tools (a.k.a. JSON Machete)
  • Get into that area/community

Issue to triage

• string parameters excluded with explode: true #4677
  • fix(json-schema): restore support for explode: true with strings #4678
• fix(deps): add missing graphql peer deps #4674
• Add flag to disable cache #4620
• In memory cache (localforage) size is ignored #4630
• Subscriptions return null values #4669
• Extend rename transform to skip primitives #4684
• https://github.com/Urigo/graphql-mesh/discussions/4664
• Is there a way to set the batch size in batch processing? #4683
• any way (or plugin) to add a new http path without using custom server? #4681
• Cannot use env values in serve references #4696 (comment)
• Supply WebSocket connectionParams to operation context and introduce connectionParams option for graphql handler #4724
• New Plugin: Generic Auth #4515
• How to handle logging #4739
• Json Schema: How to get a [string] result? #4741
• Unable to get the live query plugin to work #4730
• Service Polling / Live Schema Updates - Possible? #1142
• Any advice how to stitch ? #4755
• Different urls for subscription and query #1781
• Route to different source handlers based on condition (i.e., a filter) #4778
• Extending the schema with additionalResolvers does not work with start command when using namingConvention #4776
• Bare resolvers in incontext SDK #4731
• JSON Schema artifacts on SDL #4767
• prometheus plugin is not working when there is only one source #4738
• Runtime schema differs from generated schema in production #4799
• responseByStatusCode doesn't treat 404 as expected #4803
• serializing graphql input differently with additionalResolvers & additionalTypeDefs #4847
• Error: Cannot return null for non-nullable field when using multiple source handlers #4862
• Create a new Mesh plugin and document Generic Auth #4496
• @graphql-mesh/cross-helpers has unmet peer dependency "react-native@*" #4881

[h-dong]

@Urigo

Does this roadmap apply to all Mesh packages? I assume all the packages will start following Semantic versioning once all the issues in the V1 list are complete?

[ardatan]

After v1, we will follow semantic versioning in all packages. No breaking changes will be introduced in any minor and patch releases.

[alberthuang24]

Has support for react native been considered?

[ardatan]

@alberthuang24 Could you explain more about React Native support because currently GraphQL Mesh can be used as a client inside React Native?

[alberthuang24]

I'm using graphql-mesh as a client in react native, but it triggers an error Invariant Violation: Your JavaScript code tried to access a native module that doesn't exist.

[alberthuang24]

If it is confirmed that graphql-mesh has the intention to support react-native, I think I would like to move forward with this. @ardatan

[ardatan]

This issue is for the Roadmap :) could you create a seperate issue ?