@chromaplatform/chromajs

0.1.15 • Public • Published

Contributors Forks Stargazers Issues


Logo

chroma.js

A toolkit for communication with the chroma platform

Report Bug · Request Feature

What is

CHROMA is a real-time user & data platform that enables new ways of working with data.

The platform is not publicly available yet. We are currently building the Microdose VR network on it, but have built it to allow other projects to integrate in the future.

Getting Started

This library is only useful if you are developing on the CHROMA Platform.

Installation

Install via NPM

npm install @chromaplatform/chromajs

Basic Usage

You can use chroma.js to make queries against the platform data.

// Import chromajs into your project
import chroma from '@chromaplatform/chromajs'

// Set token in chromajs 
//   This is generally done after a successful authentication or on load 
//   if user is already authenticated)
chroma.setToken(token)

// Make queries
const query = {
    "service": "users",
    "query": {"username":"sporeganic"}
    "fields": "meta{profile{bio}}"
}
const result = await chromajs.find(query)

chromaQL

chromaQL is a query language developed to enable a wide range of data requests on the platform.

Requests are described by an object containing the details of your query.

There are three types of chromaQL queries, chroma.find(), chroma.get() and chroma.set().

chroma.find(request)

https://api.chroma.vision/query/find

{
    "service": "users",
    "query": {"username":"sporeganic"}
    "fields": "meta{profile{bio}}"
}

chroma.get(request)

https://api.chroma.vision/query/get

{
    "service": "users",
    "id": "5fe0f6702033242be27187ef",
    "fields": "meta{profile{bio}}"
}

chroma.set(request)

https://api.chroma.vision/query/set

/* This change the users email address */
{
  "id": "5fe0f6702033242be27187ef",
  "path": "users/email",
  "value": "some_new@email.com"
}

Overwrite Parameter

This will cause the key at the path's location to be overwritten with the value, regardless of if it is an object in the database.

In the following example, we would be setting the entire user.meta.profile object to the new incoming object. Usually, you do not want to overwrite entire objects, so pay close attention when using this.

/* BE CAREFUL WITH THIS */
{
  "id": "5fe0f6702033242be27187ef",
  "path": "users/meta/profile",
  "overwrite": true
  "value": {...newProfile}
}

Operator Parameter

You can change the functionality of the set method by passing an optional operator parameter.

  • "increment"

(untested/in dev)

  • "addKey"
  • "pushToArray"
  • "setArrayIndex"
  • "removeArrayIndex"
  • "addWhere"
  • "removeWhere"
  • "append"
/* This will add one minute to the users minutesPlayed */
{
  "id": "5fe0f6702033242be27187ef",
  "path": "users/meta/appData/MDVR/sessions/minutesPlayed",
  "operator": "increment",
  "value": 1
}

Contact

admin@visionagency.net

/@chromaplatform/chromajs/

    Package Sidebar

    Install

    npm i @chromaplatform/chromajs

    Weekly Downloads

    36

    Version

    0.1.15

    License

    MIT

    Unpacked Size

    1.25 MB

    Total Files

    10

    Last publish

    Collaborators

    • chromaplatform
    • ansonphong