aviondb

AvionDB: A Distributed, MongoDB-like Database

$3

!AvionDB Architecture

AvionDB uses OrbitDB stores to model MongoDB-like Databases. It creates a notion of:

- Each AvionDB instance can have several Databases.
- Each Database can have several Collections.
- Each Collection can have several Documents.

See more details in the Specs.

$3

Status: in active development

_NOTE!_ _AvionDB is alpha-stage software. It means AvionDB hasn't been security audited and programming APIs and data formats can still change. We encourage you to reach out to the maintainers if you plan to use AvionDB in mission critical systems._

This is the TypeScript implementation and it works with Browsers, Node.js & TypeScript with support for Linux, OS X, and Windows . The minimum required version of Node.js is now 8.6.0 due to the usage of ... spread syntax. LTS versions (even numbered versions 8, 10, etc) are preferred.

Table of Contents

- Table of Contents
- Install
- Using NodeJS
- In a web browser
- through Browserify
- through webpack
- from CDN
- Usage
- Example
- API
- Development
- Run Tests
- Benchmarks
- Specs
- Projects using AvionDB
- Frequently Asked Questions
- Are there implementations in other languages?
- Where can I see your Roadmap?
- What mongodb features does aviondb support?
- How can I use AvionDB in my Application?
- Other Questions?
- Contributing
- Sponsors
- License

Install

This module uses node.js, and can be installed through npm:

$3

``
// Using npm
npm install --save aviondb

// Using Github
npm install git+https://github.com/dappkit/aviondb.git
`

We support both the Current and Active LTS versions of Node.js. Please see nodejs.org for what these currently are. The minimum required version of Node.js is now 8.6.0 due to the usage of ... spread syntax. LTS versions (even numbered versions 8, 10, etc) are preferred.

$3

#### through Browserify

Same as in Node.js, you just have to browserify to bundle the code before serving it.

> Note: The code uses es6, so you have to use babel to convert the code into es5 before using browserify.

#### through webpack

Same as in Node.js, you just have to webpack to bundle the the code before serving it.

> Note: The code uses es6, so you have to use babel to convert the code into es5 before using webpack.

#### from CDN

Instead of a local installation (and browserification) you may request a remote copy of AvionDB from unpkg CDN.

To always request the latest version, use the following:

`html


`

CDN-based AvionDB provides the AvionDB constructor as a method of the global window object. Example:

`javascript
// create an AvionDB instance
const aviondb = await AvionDB.init("DatabaseName", ipfs);
`

See examples/index.html to check out a fully functioning example for AvionDB with browser.

Usage

$3

`javascript
// Import modules
import AvionDB from "aviondb";
import IPFS from "ipfs";

const runExample = async () => {
const ipfs = await IPFS.create();

// Creates a db named "DatabaseName" in the ".aviondb" directory in the project root.
// If no path option is defined, $HOME/.aviondb is used for the database directory (e.g. "C:/Users/John/.aviondb" or "~/.aviondb").
const aviondb = await AvionDB.init("DatabaseName", ipfs, {
path: "./.aviondb",
});

// Returns the List of database names
await AvionDB.listDatabases();
// prints ['DatabaseName']

// Creates a Collection named "employees"
const collection = await aviondb.initCollection("employees");

// Returns the List of collection names
await aviondb.listCollections();
// prints ['employees']

// Adding an employee document
await collection.insertOne({
hourly_pay: "$15",
name: "Elon",
ssn: "562-48-5384",
weekly_hours: 100,
});

// We also support multi-insert using collection.insert()
// See https://github.com/dappkit/aviondb/blob/master/API.md

// Search by a single field Or many!
var employee = await collection.findOne({
ssn: "562-48-5384",
});

// We also support find(), findById()
// See https://github.com/dappkit/aviondb/blob/master/API.md

// Returns the matching document
console.log(employee);
// Prints the above added JSON document

// Update a document
var updatedEmployee = await collection.update(
{ ssn: "562-48-5384" },
{ $set: { hourly_pay: "$100" } }
);

// We also support updateMany(), findOneAndUpdate()
// See https://github.com/dappkit/aviondb/blob/master/API.md

// Returns the updated document
console.log(updatedEmployee);
// Prints the updated JSON document

// await collection.close(); // Collection will be closed.
// await aviondb.drop(); // Drops the database
// await aviondb.close(); // Closes all collections and binding database.
// await ipfs.stop();
};

runExample();
`

See FAQs Section for more examples on how to use AvionDB in your project.

API

See API.md for the full documentation.

Development

$3

`
npm test
`

$3

Run Write Benchmark

`
npm run benchmarks:write
`

Run Query Benchmark

`
npm run benchmarks:query
`

Run Update Benchmark

`
npm run benchmarks:update
``

See benchmarks/ for more info on benchmarks.

Specs

We are working on the initial Specs. See AvionDB Specs doc

Projects using AvionDB

- nOS Client: nOS is a blockchain powered virtual operating system that serves as the gateway to Decentralized Applications. The nOS Client (Developer MVP Release) allows for the development of Decentralized Applications that interact with Smart Contracts in the back-end.

- bitsong-media-player: [Private Repo] BitSong Media Player for BitSong Blockchain, uses AvionDB to store, and share song tracks & metadata among the browser clients.

- js-pinza: Pinza is a IPFS pinning system using orbit-db, and aviondb as a distributed database.

- Movie-Reviews-CRUD-Application: A Kickstarter Application to understand how AvionDB Works by Implementing one.

Frequently Asked Questions

$3

We are working to implement AvionDB for following languages:

- NodeJS & Browser JS
- Typescript
- Golang
- Rust

The best place to find out what is out there and what is being actively worked on is likely by asking in the Discord.

If you want or are planning to create an implementation in a language that is not listed here, then feel free to reach us out and discuss about it in the Discord.

$3

You can find our Roadmap here. The features in the Roadmap are taken from 2 separate issues(#7, #8) which individually maintain a list of feature proposals related to OrbitDB-specific improvements & AvionDB-specific improvements respectively.

The Roadmap is an open discussion, feel free to add your suggestions, comments.

$3

You can find all the supported MongoDB-like features in our API docs.

$3

You can see the following examples to get started with AvionDB:

- aviondb-p2p-sync

A TodoList example using showing how you can sync/replicate AvionDB data across multiple devices. In this example, we synced a todolist from a desktop browser to a mobile browser using a QR Code.

- Check out the app here
- Check out the code here

- aviondb-firebase

An example using Firebase for AvionDB Access Control. In this example, we used Firebase email/password authentication as an Access Control for AvionDB (a distributed, MongoDB-like database). So, if you would try to write to AvionDB without logging in, the database will not allow you to do so internally.

- Check out the app here
- Check out the code here

- aviondb-onboard

An example using Blocknaive's OnBoard.js Auth based Access Controller for AvionDB & OrbitDB. This allows you to integrate AvionDB with @metamask_io, @TorusLabs, @authereum, @dapper_labs, @coinbase, @TrustWalletApp, @Trezor, @Ledger, @fortmatic, @portis_io, @Squarelink_Inc, @WalletConnect, @opera, @ethstatus, @unilogin, @imTokenOfficial.

- Check out the app here
- Check out the code here

- aviondb-ceramic-3id

An example using DID-agnostic Ceramic 3IDs based Access Controller for AvionDB & OrbitDB. You can join the discussion here.
Coming Soon

- aviondb-jwt

An example using JWT based Access Controller for AvionDB & OrbitDB. You can join the discussion here.
Coming Soon

- aviondb-webauthn

An example using WebAuthn based Access Controller for AvionDB & OrbitDB. You can join the discussion here
Coming Soon

$3

If you didn't find the answer to your question(s), feel free to reach us out on Discord.

Contributing

Take a look at our organization-wide Contributing Guide.

As far as code goes, we would be happy to accept PRs! If you want to work on something, it'd be good to talk beforehand to make sure nobody else is working on it. You can reach us on Discord, or in the issues section.

If you want to code but don't know where to start, check out the issues labelled "help wanted", "discussion".

Please note that we have a Code of Conduct, and that all activity in the @dappkit organization falls under it. Read it when you get the chance, as being part of this community means that you agree to abide by it. Thanks.

Sponsors

The development of AvionDB has been sponsored by:

- Dappkit

If you want to sponsor developers to work on AvionDB, please consider sponsoring using the "Sponsor" button on the top of the AvionDB Github Page.

License

MIT