ts-to-gql

TS to GQL - BETA PROJECT

Introduction

Generate graphql types based on your typescript types. DO NOT ADD the schema generated in .gitignore. Schemas are generated at development time and versioned!

💻 🚀 Api example here 🚀 💻

Example

// ./src/models/post.ts
export type GqlModelPostSelect = {
  id: string;
  body?: string;
};

// ./src/graphql/resolvers/mutations/post.ts
import { GqlModelPostSelect } from '@/models/Post';

interface CreatePostPayload {
  createPostPayload: {
    body: string;
  };
}

type GqlMutationPost = {
  createPost: (
    _: unknown,
    createPostPayload: CreatePostPayload
  ) => Promise<GqlModelPostSelect>;
};

export const MutationPostResolver: GqlMutationPost = {
  // code resolvers
}

configure ts-to-gql

import { searchGqlSchemaAndBuild } from 'ts-to-gql';


const typeDefs = searchGqlSchemaAndBuild({
  isProduction: false,
  pathScanProject: './src',
});

this.server = new ApolloServer<MyContext>({
  resolvers,
  typeDefs,
});

And magic, your types in graphql

type PostSelect  {
  id: String!
  body: String
};

interface CreatePostPayload {
  createPostPayload: {
    body: string;
  };
}

type Mutation {
  createPost(createPostPayload: CreatePostPayload): PostSelect!
}

Options searchGqlSchemaAndBuild

command	example	description
(required) isProduction	true or false
true will use the generated and versioned schema in the source code. false, it will generate a new schema every hot reload (or reload) of your application.
(required) pathScanProject	'./src'	path to search models, queries and mutations
pathSaveSchema	'./schema.graphql'	path to save schema
prefixModel	'Model' or 'GqlModel' for example	prefix to search models
prefixMutation	'Mutation' or 'GqlMutation' for example	prefix to search mutations
prefixQuery	'Query' or 'GqlQuery' for example	prefix to find queries
removePrefixFromSchema	true or false	if true, remove prefix schema in final schema
fixSchema	(schemaGql: string): string => schemaGql	function to fix schema, add new values or modify existents. Use to add things the library doesn't support for now

Special types

if necessary use Float, Int, ID or similar, import special types from 'ts-to-gql'. Typescript types like string, number, boolean are automatically converted to String, Number and Boolean respectively.

import {  Int, ID, DateTime, Float } from 'ts-to-gql';

Int, Float is string, DateTime is Date, and ID is string

Common errors on migration

Migration is manual, for now.

1. Not use Partial, extends, implements, or advanced typescript. for now

2. use types, not interfaces (for now)

3. ts-to-gql use only second param, define first param or contexts for example

type MutationPost = {
 createPost: (input: CreatePost) => Promise<ModePost>;
}

to

type MutationPost = {
 createPost: (_: unknown, input: CreatePost) => Promise<ModePost>;
}

---

4. replace your resolver to arrow types, this

type MutationPost = {
 createPost(_: unknown, input: CreatePost): Promise<ModePost>;
}

to

type MutationPost = {
 createPost: (_: unknown, input: CreatePost) => Promise<ModePost>;
}

5. use prefix, for ts-to-gql find your models, queries and mutations (other not necessary)

type MyPost = {}

to

type MutationMyPost = {}