Convert E2Es to examples

[enisdenjo]

• Transforms an E2E test to a runnable example
  • Never worry about writing examples, write E2Es and let the @internal/examples converter do the rest
• The converter makes sure examples work by running them and checking whether gateway is healthy
• Runs in CI
  • Examples are always be up-to-date with the latest versions
  • Examples are continuously tested through E2Es and by the converter itself which makes sure the gateway is healthy after running
  • As we cut new versions, examples will update too
• Plug-n-Play for Codesandbox Devboxes
  • Installs with npm i
  • Intentionally outside workspace (each example will have its lockfile)
  • Defines setup and tasks for the devbox and tests them
  • When viewing an example on github.com, just append "box" to "github" (githubbox.com) and you'll get the example running in a CodeSandbox Devbox
    • Run extra-field example from this branch with githubbox.com/graphql-hive/gateway/tree/e2e2example/examples/extra-fields

TODO

• Warn that examples are auto-generated and not to be modified directly
• Container Sandboxes are deprecated, use Codesandbox Devboxes instead
• Support createExampleSetup
• Convert rest of relevant E2Es
• Run containers used for E2Es (do Codesandbox Deboxes even support it?)

[ardatan]

This will create workflows for each example which might cause a bigger queue. But instead maybe we can run this once and configure converted e2es in a file, no?

[Urigo]

very cool