.meshrc.yaml variable interpolation injection points

[loganpowell]

Hi there!

I was so happy to have been away from graphql for about a year and - upon coming back to it - realizing that schema-stitching is not only back, but with a fury with graphql-mesh!

I'm working through some of the guides, but have a pretty specific need and haven't been able to find docs that go over the various ways we can securely (given git) set up our .meshrc.yaml config files with the ${ interpolated } value syntax.

What are the various strategies for setting these so they don't get committed to git?

Great work and the best of luck to the project!

[ardatan]

Thank you for your kind words :)
This is how environmental variables injected;
https://github.com/Urigo/graphql-mesh/blob/master/examples/postgres-geodb/.meshrc.yaml#L15
This is how you can inject dynamic context and arguments;
https://github.com/Urigo/graphql-mesh/blob/master/examples/json-schema-covid/.meshrc.yml#L13

[loganpowell]

aha! Thanks!

I just realized there's this new thing called Github Discussions. I thought my issue got deleted.

QQ, so in this example:

sources:
  - name: Covid
    handler:
      graphql:
        endpoint: https://covid-19.dava.engineer/api/graphql
  - name: WorldPop
    handler:
      jsonSchema:
        baseUrl: https://datasource.kapsarc.org/api/records/1.0/search
        operations:
          - type: Query
            field: population
            path: /?dataset=world-population&q={args.country}&rows=1&sort=year&facet=year&facet=country_name
            method: GET
            responseSchema: ./src/json-schemas/worldPop.json

the {args.country} would be provided in the CLI like country=US graphql-mesh serve?

[ardatan]

No args.country asks Mesh to create a parameter on that root field named country and put that value there in the URL. If you want to use an environmental variable as in the first example, you need to use ${ENVVAR}.

[loganpowell]

No args.country asks Mesh to create a parameter on that root field named country and put that value there in the URL

Do you mean as a URL parameter (e.g., after ?)?

[ardatan]

Let me explain from scratch. There are two types of dynamic variables in GraphQL Mesh;

• Environmental Variables (Standard in all YAML files);

someparameterorvalue${YOUR_ENVIRONMENTAL_VARIABLE}someothervalue

${YOUR_ENVIRONMENTAL_VARIABLE} will be replaced by the actual value. For example if you run your project like below;

YOUR_ENVIRONMENTAL_VARIABLE=MYVALUE yarn start

So interpolated config file will be processed like below;

someparameterorvalueMYVALUEsomeothervalue

• Resolver Data;
  In GraphQL, resolver functions will take 4 parameters; (If you don't know much about those, you can learn more in GraphQL Official Documentation)
• • root -> Parent Value
• • args -> Arguments of the field
• • context -> Context (usually contains request object)
• • info -> GraphQLResolveInfo

So you can use those in Mesh configuration ;

sources:
  - name: Covid
    handler:
      graphql:
        endpoint: https://covid-19.dava.engineer/api/graphql
  - name: WorldPop
    handler:
      jsonSchema:
        baseUrl: https://datasource.kapsarc.org/api/records/1.0/search
        operations:
          - type: Query
            field: population
            path: /?dataset=world-population&q={args.country}&rows=1&sort=year&facet=year&facet=country_name
            method: GET
            responseSchema: ./src/json-schemas/worldPop.json

Mesh will detect a dynamic argument in here. If you do a query like below;

{
  population(country: "Italy") {
   ...
  }
}

Mesh will replace passed value in path parameter. And it will become like below;

path: /?dataset=world-population&q=Italy&rows=1&sort=year&facet=year&facet=country_name

[loganpowell]

aha! Thank you for the thorough lesson sir. I really appreciate you taking the time to help me 🙏