@mikojs/koa-graphql ·

Collect the graphql files to build the graphql automatically.

Install

yarn add koa graphql @mikojs/koa-graphql

Use @mikojs/koa-graphql to server

1. Add the middleware to server.

import Koa from 'koa';
import Graphql from '@mikojs/koa-graphql';

const app = new Koa();
const graphql = new Graphql('./path-to-graphql-foder');

app.use(graphql.middleware());

2. Write the graphql files in ./path-to-graphql-foder.

// @flow

export default {
  typeDefs: `
  type Query {
    version: String!
  }
`,
  Query: {
    version: () => '1.0.0',
  },
};

Add the additional schema

Use with string:

const graphql = new Graphql('./path-to-graphql-foder', {
  typeDefs: `
  type AdditionalType {
    key: String!
  }
  `,
  resolvers: {
    AdditionalType: () => { ... },
  },
});

Use with Array:

const graphql = new Graphql('./path-to-graphql-foder', {
  typeDefs: [
    `
  type AdditionalType {
    key: String!
  }
`,
    `
  type AdditionalTwoType {
    key: String!
  }
`,
  ],
  resolvers: {
    AdditionalType: () => { ... },
    AdditionalTwoType: () => { ... },
  },
});

Update resolver with babel watch

const graphql = new Graphql('./path-to-graphql-folder');

chokidar
  .watch('./path-to-graphql-folder', {
    ignoreInitial: true,
  })
  .on('change', (filePath: string) => {
    graphql.update(filePath);
  });

Note: This function will only update the resolvers. This can not update the schema definition becuse graphql-tool does not support add new schema definition.

Give the options to makeExecutableSchema

Expect for typeDefs and resolvers, you can add the other options in makeExecutableSchema to this middleware.

const graphql = new Graphql('./path-to-graphql-foder', {
  options: { ... },
});

Give the options to express-graphql

Expect for schema, you can add the other options to this middleware.

...
app.use(graphql.middleware({ ... }));
...

Use to compile with relay-compiler

1. Write a bin file or make server file to be a bin file.

#! /usr/bin/env node

import Koa from 'koa';
import Graphql from '@mikojs/koa-graphql';

const app = new Koa();
const graphql = new Graphql('./path-to-graphql-foder');

(async () => {
  if (process.env.RELAY_COMPILER) {
    await graphql.relay(['relay-compiler', 'command', 'without', 'schema']);
    process.exit();
  }

  app.use(graphql.middleware());
})();

2. Run command with the bin file.

RELAY_COMPILER=true node ./server.js

Use in the unit testing

import Graphql from '@mikojs/koa-graphql';

const graphql = new Graphql('./path-to-graphql-foder');

test('test', async () => {
  expect(await graphql.query({
    source: '{ version }',
    ...
  })).toEqual({ ... });
});

This function use graphql to query, you can see here to lerna the more information.