# useDatabase

When using the database in Rebar it can be accessed from any plugin.

However, the database may only be accessed on server-side.

Use the Document system if you are updating characters, accounts, or vehicles.

# useDatabase

Import the database into your plugin file, and begin using it.

import { useRebar } from '@Server/index.js';

const Rebar = useRebar();

const { get, create, getAll, getMany, update, deleteDocument, createCollection } = Rebar.database.useDatabase();

# createCollection

A collection is where documents are stored.

const db = Rebar.database.useDatabase();

async function createCollections() {
    await db.createCollection('Person');
    await db.createCollection('PhoneData');
}

# create

Creating data uses the create function and returns an _id to obtain the data.

async function test() {
    const _id = await create({ name: 'Stuyk', age: 30 }, 'Person');
}

# get

If you want to get a document by an _id, you can use this:

async function test() {
    const _id = await create({ name: 'Stuyk', age: 30 }, 'Person');
    const user = await get<{ name: string }>(_id);
    if (!user) {
        console.warn('Could not find the data!');
        return;
    }

    console.warn(`Found ${user.name}`);
}

# getMany

After creating data, if you don't have an _id and you want to find it. You can use getMany.

async function test() {
    const results = await getMany<{ name: string }>({ name: 'Stuyk' }, 'Person');
    if (results.length <= 0) {
        console.warn('Could not find the data!');
        return;
    }

    const user = results[0];
    console.warn(`Found ${user.name}`);
}

# getAll

It is not recommended to fetch a whole collection unless it's a smaller collection.

In any case, you can use this to fetch a whole collection of data.

async function test() {
    const results = await getAll<{ name: string }>('Person');
}

# update

If you want to update a document, or simply append new data to the document.

async function test() {
    const _id = await create({ name: 'Stuyk', age: 30 }, 'Person');
    const didUpdate = await update({ _id, name: 'NotStuyk' }, 'Person');
    if (!didUpdate) {
        return;
    }
}