Biota has been living for a while in a new dedicated Organization over there: https://github.com/biotajs
Gabin.
A simple database framework to start your next project in 30s with FaunaDB
Find the raw documentation here.
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" } }]
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!
These instructions will take you through the few steps to get started playing with your Fauna database.
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 { Biota } from "biota";
// or
const { Biota } = require("biota");
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(...) )
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.. :)
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)
If you want to run the tests, you'll need to provide a FAUNA_KEY_TEST=<your-test-key>
in a .env
file.
โ ๏ธ Careful: At the moment tests covering everything yet. PR welcomed ๐
- fauna-db-js - Javascript driver for FaunaDB
Please read CONTRIBUTING.md for details on our code of conduct, and the process for submitting pull requests to us.
We use SemVer for versioning. For the versions available, see the tags on this repository.
- Gabin Desserprit instigator
See also the list of contributors who participated in this project. Join us ๐ป
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 ๐