Argument standardization

[ntziolis]

When dealing with downstream sources (especially legacy and/or third party) they are likely to implement common features very differently, some examples:

• List query pagination
  • pagination type (offset vs record id vs cursor)
  • name of arguments skip / offset etc.
• Single object query
  • individual args per key vs one arg with multiple properties
  • names of id args
• Mutations (little more complex and might be out of scope)
  • when updating / inserting individual args vs one object

When building data driven apps it would be extremely beneficial when all sources could be accessed via the same API. This would significantly reduce complexity on the client. As well as enable the creation of reusable data components.

Describe the solution you'd like

• Assuming a standardized args format is defined by mesh for different operation types (list get single etc)
• Create a transform that
  • Changes the exposed schema for a downstream resolver and translates the incoming operation structure to the internally required one
  • Can be configured (on a per resolver basis with defaults from source and root) how to convert the standardized args format to the one required by the downstream source)

As an additional step it might also be possible to configure the standardized args format that is exposed by mesh.

Describe alternatives you've considered
We understand that this is possible today by manually creating custom transforms. However we believe this is something that can be standardized and provide enormous value to the mesh community as well as significantly expand the use cases for mesh especially in an enterprise environment.