@hexalts/rdbc


> Make sure you have set up the RDB Server side. Please refer to this link.

Instalation

``shell
yarn add @hexalts/rdbc
`

Example

---

$3

Let's say you already have a MongoDB with collection cats with multiple documents of cat. You want to get it all for once.

First, you need to set up the RDB Configuration.

`javascript
import RDB from '@hexalts/rdbc';

const instanceId = 'random UUIDv4'
const RDB = new RDB(
{
host: 'wss://broker.address.com:8883',
},
instanceId
);

`

> You can try to generate an UUID v4 on this page, and make sure the client instanceId matches with the server instanceId. Otherwise it won't work.

Next step is to set up the database target and the collection we want to use.

`javascript
const instance = RDB.Database('hexalts');
instance.Collection('cats');
`

Note that you only need to do this setup for once. It is dead simple. Then you can get all those cat like this.

`javascript
const getAllCats = async () => {
const result = await instance.Get();
console.log(result);
};

getAllCats();
`

$3

What if you want to listen to changes that affected any documents inside cats collection, while you get all documents inside cats collection at once? No worries, because it is as easy as this.

`javascript
const watchThoseCats = async () => {
const stream = instance.Stream('all');
stream.on('data', (data) => {
console.log(data);
})
};

watchThoseCats();
`

$3

What if you want to get documents with multiple rules? Let's assume you have such documents

`
[
{
_id: '1',
name: 'ciyo,
age: 2,
race: 'persian medium',
},
{
_id: '2',
name: 'izzy',
age: 1,
race: 'persian medium'
},
{
_id: '3',
name: 'mio,
age: 3,
race: 'persian medium'
},
{
_id: '4',
name: 'qio,
age: 4,
race: 'himalayan'
},
]

`

Let's say you want to get any persian medium cats with age greater than 1. It goes like this.

`javascript
const whereAreThoseCats = async () => {
instance.Where('race', '==', 'persian medium')
instance.Where('age', '>', 1)
const stream = instance.Stream('all');
stream.on('data', (data) => {
console.log(data);
});
};

whereAreThoseCats();
`

It will return

`
{
_id: '1',
name: 'ciyo,
age: 2,
race: 'persian medium',
}
{
_id: '3',
name: 'mio,
age: 3,
race: 'persian medium'
},
`

First, it will fetch you all documents which meets your rules. And then, once a document (which meets the rules) got changed, an event will be emitted over the stream.on with event name data, the data it emits is the one which got changed, it will not return the whole documents (which meets the rules) again because that will be inefficient.

$3

A note to remember:

>The Where() method actually push any query into the instance state, it means you need to Clear the Where condition to default every time you need a different query pattern.

But don't worry, because it is as easy as this.

`javascript
instance.Clear();
`

$3

Let's say you inputted ciyo accidentally (it should be cio) and you want to update the document. Well, you got two ways to do that.

1. If you know the document id.

`javascript
const changeCatName = async () => {
instance.Where('_id', '==', '1')
const result = await instance.Update({ name: 'cio' });
console.log(result);
};

changeCatName();
`
2. If you don't remember the document id.

`javascript
const changeCatName = async () => {
instance.Where('name', '==', 'ciyo')
const result = await instance.Update({ name: 'cio' });
console.log(result);
};

changeCatName();
`

$3

Let's say cio has just passed away and you want to move on, completely. Just like the Update method, you can use Where condition to delete it


1. If you know the document id.

`javascript
const changeCatName = async () => {
instance.Where('_id', '==', '1')
const result = await instance.Delete();
console.log(result);
};

changeCatName();
`
2. If you don't remember the document id.

`javascript
const changeCatName = async () => {
instance.Where('name', '==', 'ciyo')
const result = await instance.Delete();
console.log(result);
};

changeCatName();
``

Full API Documentation

For deeper understanding of Hexatls Realtime Database APIs, please refer to this dcumentation.