Composedql NPM

ComposedQL

ComposedQL is a query language that aims URI friendly queries for RESTful APIs.

Use Cases

Composing data queries with efficient way
Selecting only a subset of data
Filtering sensitive information
Creating authZ compatible API endpoints
Improving caching and routing

Design Goals

URI friendly queries
High performance query parsing
Exchangeable and human readable/writable structure

Specification

(work in progress)

Fields represent object properties, resources or functions.
- Examples:
  - foo - field
  - ~foo - resource
  - foo() - function
Commas are separators for fields or function arguments
- Examples;
  - foo,bar - fields
  - ~foo(bar,baz) - resource fields
  - foo(bar,baz) - function arguments
Dots are accessors for accessing nested fields or field functions
- Examples;
  - foo.bar - nested field
  - ~foo(bar.baz) - nested resource field
  - foo.bar() - field function
  - foo(bar).baz(qux) - function chain
  - ~foo(bar).baz(qux) - resource field chain

Notes

This repository provides composed query language parser and specifications.

Installation

npm install composedql

Usage

var cql = require('composedql');

parse

Parses given composed query

cql.parse('user,location.city');

[ { name: 'user',
    type: 'field',
    source: 'user' },
  { name: 'location',
    type: 'field',
    source: 'location.city',
    properties: [ { name: 'city', type: 'property' } ] } ]

cql.parse('user,~photo(profile,cover),~post(id,text).from(today)');

[ { name: 'user',
    type: 'field',
    source: 'user' },
  { name: 'photo',
    type: 'resource',
    source: '~photo(profile,cover)',
    fields:
     [ { name: 'profile',
         type: 'field',
         source: 'profile' },
       { name: 'cover',
         type: 'field',
         source: 'cover' } ] },
  { name: 'post',
    type: 'resource',
    source: '~post(id,text).from(today)',
    fields:
     [ { name: 'id',
         type: 'field',
         source: 'id' },
       { name: 'text',
         type: 'field',
         source: 'text' } ],
    properties:
     [ { name: 'from',
         type: 'function',
         args:
          [ { name: 'today',
              type: 'arg',
              source: 'today' } ] } ] } ]