reqt

A data store for modern JS applications, using the Fetch API.

Features

• Uses the WHATWG Fetch polyfill to ensure native compatibility in future browsers.
• Lazily makes requests until data is needed
• Most methods are chainable for composability
• Serializes all objects to JSON

Installation

Install with your favorite package manager:

npm install reqt

...or...

yarn add reqt

You can also install from source with the following steps:

git clone https://github.com/tubbo/reqt.git
cd reqt
yarn install
yarn build

Usage

Import the find() function to fetch JSON data from your API:

import { find } from 'reqt';

find('users').byID('test').then(user => console.log(user));

You can also use the create() function to create new data from existing actions:

import { create } from 'reqt';

let params = {
  name: 'test',
  password: 'password'
};

create('users').with(params).then(user => console.log(user));

Updating found resources

After finding a resource, it's possible to mass-assign attributes, update single attributes, or flat-out replace an entire resource using the reqt DSL.

To update a single or collection of attributes on a single resource (using the PATCH method):

import { find } from 'reqt';

find('users').byID(1).update.with({ password: 'newpassword' });

You can also replace entire resources with the PUT method and the replace action in Reqt:

import { find } from 'reqt';

find('users').byID(1).replace.with({
  id: 1,
  username: 'test',
  password: 'newpassword'
});

Destroying Resources

After finding a resource, you may want to issue a DELETE request. To do this, run the following:

import { find } from 'reqt';

find('users').byID(1).destroy();

The destroy() method will automatically call the promise, so calling then() will execute any code immediately.

How It Works

Reqt is a chainable HTTP request builder, meaning most of its methods just return the initial Store object that was instantiated using find() or create(). Data is "lazily" loaded, which is achieved through the use of [Promises][promises]. Since fetch() already returns promises, developers using Reqt are working with an expected API.

Development

Contributions are encouraged using GitHub Pull Requests. All contributions must pass the test suite and are subject to the code of conduct.

To run the test suite:

yarn test