ts2graphql

This tool converts your typescript interfaces to graphql schema.

// schema.ts

import { ID, Int, Float } from 'ts2graphql';
interface Query {
    getByAuthor?(args: { id: ID }): Author;
}

interface Author {
    id: ID;
    name: string;
    books(filter: { max?: Int }): Book[];
}

type Book = PDFBook | AudioBook;

interface BookBase {
    /** The authors of this content */
    authors: Author[];
    name: string;
    publishedAt: Date;
    illustrator?: {
        __typename: 'Illustrator';
        name: string;
        email: string;
    };
}

interface PDFBook extends BookBase {
    file: string;
}

interface AudioBook extends BookBase {
    audioFile: string;
}

// index.ts

import { printSchema } from 'graphql';
import { createSchema } from 'ts2graphql';

const schema = createSchema(__dirname + '/schema.ts');
const rootValue = {}; // you should implement resolve methods
express.use(
    '/api/graphql',
    graphqlHTTP({
        schema: schema,
        rootValue: rootValue,
    })
);

console.log(printSchema(schema));

will generate schema

type AudioBook {
  audioFile: String!

  """The authors of this content"""
  authors: [Author!]!
  name: String!
  publishedAt: Date!
  illustrator: Illustrator
}

type Author {
  id: ID!
  name: String!
  books(max: Int): [Book!]!
}

union Book = PDFBook | AudioBook

scalar Date

type Illustrator {
  __typename: String!
  name: String!
  email: String!
}

type PDFBook {
  file: String!

  """The authors of this content"""
  authors: [Author!]!
  name: String!
  publishedAt: Date!
  illustrator: Illustrator
}

type Query {
  getByAuthor(id: ID!): Author
}