biota

A simple database framework to start your next project in 30s with FaunaDB

GitHub npm bundle size

import { Biota } from "biota";

// 4 lines to:
const db = new Biota({ secret: "<your-secret>" });

// - scaffold the whole database (inc. users collection for ex)
await db.foundation();

// - add todos collection
await db.collection("todos").scaffold();

// - add autocomplete-search on name field
await db.collection("todos").index({ field: "name", ngram: true });

// 4 lines to:
// - create a user & login
let asUser = await db.user().register("my@email.com", "password", {
  nickname: "Georgy",
});

// - create a todo
await asUser.documents("todos").insert({ name: "Remember to star this project" });

// - query a todo with $ngram (autocomplete behavior)
await asUser.documents("todos").find({ name: { $ngram: "star" } });
// output: [{ ref, ts, data: { name: "Remember to star this project" } }]

Current status

Finishing up design and tests of the main API (400+ methods).

🙃 You're on preview release. Don't get scared though, the api is pretty stable but tests need to be added to be fool-proof. (Thus, as of yet, Biota isn't production ready)

❤️ Check the features and request the ones you would love to see in biota. (They arn't all listed yet!)

Found some errors? Let us know!

Getting Started

These instructions will take you through the few steps to get started playing with your Fauna database.

Prerequisites

You'll need to add biota either as a global or local (project) dependency.

yarn add biota // -G for global
// or
npm i biota // -G for global

Import

import { Biota } from "biota";
// or
const { Biota } = require("biota");

Instance

There are two ways to instantiate Biota.

You can use a admin/server key (or any secret key) as a paremeter.

const db = new Biota({ secret: "<your-secret>"})
// example
await db.query( q.Create(...) )

You can use the function .login(id, password) to log a user.

const db = new Biota()
const logged = await db.login("123", "super_password123")
// which is a shortcut for
const logged = await db.current.user.login("123", "super_password123")

// example
await logged.query( q.Create(...) )

Api

Even though you can query your database (same as you would do with the same fauna method query), the main power of Biota lives in its extended api.

⏳ Patience: It's coming.. :)

Helpers

const { q, factory, Page } = require('biota')
// q: export the query builder, same as fauna.query
q.If(..., true, false)
// factory: export the factory api (helpers that wrap FQL)
factory.database(ctx)(name).insert(options)

Running the tests

If you want to run the tests, you'll need to provide a FAUNA_KEY_TEST=<your-test-key> in a .env file.

:warning: Careful: At the moment tests covering everything yet. PR welcomed 😉

Built With

fauna-db-js - Javascript driver for FaunaDB

Contributing

Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.

Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

Authors

Gabin Desserprit instigator

See also the list of contributors who participated in this project. Join us :beers:

License

This project is licensed under the MIT License - see the LICENSE.md file for details

This lib wouldn't exist if I had not dug deep into Fauna FQL and got helped through the Fauna's slack community channel. In no order, I'ld like to thank, for their help and support, fauna's team (Brecht De Rooms, Ben Edwards, Marrony Neris, Leo Regnier, Summer, ,...) as well as other users like Eigil Sagafos 🙏