PocketAces

An Experimental GrpahQL framework

Note: under heavy development. Do not use in production.

Features to build

The following features will be implemented:

• GraphQL First: Built for making GraphQL server without hassle
• High Performance: Efficient data loading by default
• Opinionated: No worry about directory structure, library, testing
• Realtime: Built-in subscriptions, live queries
• Ergonomic: Less code, great DX
• Free DB choice: Can support major databases (PG, MySQL, and so on)
• Type Safe: 100% Written in TypeScript (or Deno)

Getting Started

Install:

yarn add @pocket-aces/core graphql sqlite3

Define your app:

1// app.js
2
3const { PocketAces } = require('@pocket-aces/core')
4
5const app = new PocketAces()
6
7app.registerResolver('hello', () => 'world')
8app.configureDatabase({
9  client: 'sqlite',
10  connection: {
11    filename: ':memory:',
12  },
13})
14app.buildSchema(`
15  type Query {
16    hello: String!
17    users: [User!]! @all(table: "users")
18  }
19
20  type Mutation {
21    createUser(name: String!): User @create(table: "users")
22  }
23
24  type User {
25    id: ID!
26    name: String!
27  }
28`)
29app.initialize()
30
31const sql = `
32  create table users (
33    id integer not null primary key autoincrement,
34    name string not null default ''
35  )
36`
37
38app.sql(sql).then(() => {
39  app.runApplication()
40})

I know the above code is ugly. We'll improve it soon.

Then run node app.js.

You can now run GraphQL queries to http://localhost:3000

1curl -XPOST localhost:3000/graphql -d query='{ hello }'

Directory structure for the Framework

.
|-- cmd              # CLI command
|  |-- SomeTask.ts
|  `-- index.ts
|-- config           # App configuration
|-- jobs             # Async jobs
|-- middlewares      # HTTP Middlewares
|-- policies         # Policies
|-- resolvers        # Custom resolvers
|-- schema           # GraphQL Schema (every file in this dir loaded)
|  `-- index.gql
`-- tests            # Tests
   |-- feature
   | `-- LoginUserTest.ts #
   `-- unit #
     `-- LoginUserTest.ts #

Built with

Main dependencies:

• Koa
• GraphQL
• Knex
• TypeDI
• Dataloader

Development:

• TypeScript, ts-node
• Ava
• Supertest
• SQLite
• Lerna
• Rollup

Heavily inspired by https://github.com/nuwave/lighthouse