koa-server

GraphQL Back-end Server with Relay, Koa, MongoDB and Mongoose

🚧 WIP 🚧

Note See Front-end project graphql-relay-web

Stack

• Koa
• MongoDB
• Mongoose
• GraphQL
• Relay
• Jest
• SuperTest
• Code Coverage(Coverall) see
• Linter (Eslint)
• Prettier

Project architecture

.
├── graphql/
│   └── schema.graphql
├── script
├── src/
│   ├── __tests__
│   ├── database
│   ├── graphql
│   ├── modules/
│   │   ├── event/
│   │   │   ├── __tests__
│   │   │   ├── fixure
│   │   │   ├── mutations/
│   │   │   │   ├── __tests__
│   │   │   │   ├── EventCreateMutation.ts
│   │   │   │   ├── EventDeleteMutation.ts
│   │   │   │   ├── EventUpdateMutation.ts
│   │   │   │   └── index.ts
│   │   │   ├── EventFilterInputType.ts
│   │   │   ├── EventLoader.ts
│   │   │   ├── EventModel.ts
│   │   │   └── EventType.ts
│   │   └── node/
│   │       └── typeRegister.ts
│   ├── schema/
│   │   ├── MutationType.ts
│   │   ├── QueryType.ts
│   │   └── schema.ts
│   └── shared
└── test

Getting Started

• clone this repo

# install dependencies
> yarn
# or
> yarn install

# copy .env file
> cp .env.example .env

# start project
> yarn start

# see on GraphiQL graphql interface on localhost link
http://localhost:9000/graphql

# or see graphql Playground
http://localhost:9000/playground

Generating the schema

> yarn schema

Create events manually

> yarn seed

to-do

• projects

demo

• 🔗 https://koa-server-production.up.railway.app/
• 🔗 https://koa-server-production.up.railway.app/graphql
• 🔗 https://koa-server-production.up.railway.app/playground

Mutations

• Event Create Mutation

mutation {
  EventCreate(
    input: {
      eventId: 564654
      name: "nice event"
      start: "2022-07-01T00:00:00.000Z"
      end: "2022-07-01T23:59:59.000Z"
      allDay: false
    }
  ) {
    event {
      id
      name
      start
      end
      allDay
    }
    error
    success
  }
}

• Event delete Mutation

mutation {
  EventDelete(input: { eventId: "629521641ff2c2c8f5f2e449" }) {
    eventId
    error
    success
  }
}

• Event Update Mutation

mutation {
  EventUpdate(
    input: {
      eventId: "62952906f5c651ced019adf3"
      name: "nice event /o/"
      start: "2022-07-01T00:00:00.000Z"
      end: "2022-07-01T23:59:59.000Z"
      allDay: false
    }
  ) {
    event {
      id
      name
      start
      end
      allDay
    }
    error
    success
  }
}

Queries

• Event queries

query {
  events {
    edges {
      node {
        name
        start
        end
        allDay
      }
    }
  }
}

contributions

Feel free to contribute to this project, if you find any bugs or improvements, open an issue and send a PR about it \o/