@cuba-platform/rest

JavaScript library for working with CUBA Platform's REST API v2

Stats

StarsIssuesVersionUpdatedCreatedSize
@cuba-platform/rest
201182.1.05 months ago4 years agoMinified + gzip package size for @cuba-platform/rest in KB

Readme

CUBA REST JS

Build Status

JavaScript library for web and Node.js which facilitates CUBA Platfotm's REST API usage.

Installation

npm

npm install @cuba-platform/rest --save

Import as module

const cuba = require('@cuba-platform/rest');

Or using ES6 imports:

import * as cuba from '@cuba-platform/rest';

bower

bower install cuba-platform/cuba-rest-js
<script src="./bower_components/cuba-rest-js/dist-browser/cuba.js">

Dependencies and requirements

Library has no external dependencies. It's assumed that Promise and fetch -compatible API are available or polyfilled i.e. in node environment:

npm install node-fetch --save
global.fetch = require('node-fetch');

Usage

import * as cuba from 'cuba-rest-js';

const app = cuba.initializeApp({
  name: 'myApp',
  apiUrl: 'http://localhost:8080/app/rest/'
});

app.getUserInfo().then((d) => {
  console.log(d);
});

// retrieve app by name

const myApp = cuba.getApp('myApp');

or use if you want to manage instances yourself

const myApp = new CubaApp("myApp", "http://localhost:8080/app/rest/")
myApp.loadEntities('sec$User', {view: '_minimal', sort: 'login'}).then((users) => {
  console.log(users);
});

Full API reference

Development

Tests

In order to run integration tests you need Java to be installed.

Integration tests

npm run test:integration

Running manually

Start test CUBA app

npm run start-test-app

Run tests

npm test

Stop test app

npm run teardown-test-app

Build

npm run dist

Lint

npm run lint

If you find any bugs or have a feature request, please open an issue on github!

The npm package download data comes from npm's download counts api and package details come from npms.io.