What is JSON:QL? JSON Query Load :)

IMPORTANT NOTE: This repo is currently under heavy development and many of the existing module will get transfer to our new @jsonql npm namespace Please check out website jsonql.org for update to date information

jsonql tools

This is a collection of JSONql tools starting with jsonql-client and jsonql-koa

What is jsonql

This is not a replacement of REST or GraphQL, instead we are focus on the last one mile.

The communication protocol is based on JSON API.

It's intend for communication between different devices or services.

And the main goal is to write the resolver (on server side) once, and the client doesn't need any code written and it should work.

It's like this

  client <--> contract <--> server

Query, Mutation, Auth

There are only three types of calls. query, mutation and auth

For more information please check one of our following available modules

• jsonql-koa json:ql Koa middleware
  
• jsonql-client json:ql Javascript client using Superagent
  
• jsonql-node-client json:ql Node.js client
  
• jsonql-contract json:ql command line util that creates the contract.json
  
• jsonql-constants json:ql constants for development purpose
  
• jsonql-ws-server json:ql Web Socket Server support ws and socket.io
  
• jsonql-params-validator json:ql resolvers validate interface for both client and server
  
• jsonql-errors json:ql errors classes for use in all the jsonql js projects
  

There are several more in the planning stage

• json:ql ws-client the websocket client for Browser
• json:ql rx-client - this is the new client that replace the fetch / ws client using stream
• json:ql ts-koa - this is the Typescript port for the server side This will replace by json:ql-deno
• json:ql ts-rx-client - the rx client using Typescript
• json:ql Go
• json:ql Dart
• json:ql ASP.NET

If you are interested in creating your implementation please do not hesitate to contact us.

Work on this project

Please first fork this repo. Then setup your git as follow:

$ git remote add upstream git@gitee.com:to1source/jsonql.git
$ git remote -v
$ git fetch upstream

Once you are done coding, please PR your code for checking. Please make sure you have written test accordingly before PR.

Documentation (coming soon)

Full documentation at json:ql

MIT

Co-Develop by to1source LTD China and NEWBRAN LTD UK