gql-types-generator

gql-types-generator

Package to generate types depending on GraphQL schema.

Install

npm install --save gql-types-generator

yarn add gql-types-generator

Usage

gql-types-generator provides 2 ways of generating types:

1. Command line interface;
2. TypeScript / JavaScript code.

Command line interface

After installation of package is done, gql-types-generator command becomes available.

Usage: gql-types-generator [options]

Options:
  -o --output-path <path>        path to file where typings will be saved
  -s --schema-artifacts <globs>  glob used to find schema artifacts. These artifacts will be concatenated into the only 1 file and parsed by graphql package
  -h, --help                     display help for command

Programmatic control

If needed, you can use compile function to generate types.

import {compile} from 'gql-types-generator';
import * as path from 'path';

compile({
  source: [
    path.resolve(__dirname, 'schema-artifacts-folder-1/*.graphql'),
    path.resolve(__dirname, 'schema-artifacts-folder-2/*.graphql')
  ],
  outputPath: path.resolve(__dirname, 'types.d.ts'), 
});

// OR

compile({
  source: path.resolve(__dirname, 'schema-artifacts/*.graphql'),
  outputPath: path.resolve(__dirname, 'types.d.ts'),
});

// OR

compile({
  // You can pass gql schema directly 
  schema: 'type Query { ... }',
  outputPath: path.resolve(__dirname, 'types.d.ts'),
});