0.1.2 • Published 6 years ago

gun-elastic v0.1.2

Weekly downloads
1
License
MIT
Repository
github
Last release
6 years ago

Gun-Elastic

Elasticsearch native persistence layer for Gun, a realtime, distributed, offline-first, graph database engine.

This gun storage adapter interfaces with Elasticsearch using an extended flint node strategy:

  • get request expect to read an entire Gun node.
  • put requests write an entire Gun node.
    • node key-value structure (soul,relation,field,value,state) optionally saved to secondary index

THIS WORK IS EXPERIMENTAL WORK IN PROGRESS! USE AT YOUR OWN RISK!

Comments and PR/Contributions are super welcome!


Installation

npm install gun-elastic.

const Gun = require('gun');

// Must be added after Gun but before instantiating Gun
require('gun-elastic');

// Instantiate Gun
const gun = new Gun({
    file: false,
    web: httpServer,

    // The following are defaults.
    elastic: {
        host: 'localhost',
        port: '9200',
        index: 'gun_es',
        type: 'gun_data',
        
        store_keys: false,
        store_keys_index: 'gun_es_keys'
    }
});

Screenshots

Network Relations

Circular Sankey

Todo

  • Optional Key Storage in secondary index
  • Authentication support, array of servers, etc
  • Add tests with ES mockups

Credit

This extension is made possible by gun-flint @sjones6

Issues & Contributing

Issues welcome on Github.

Community contributions welcome. PRs accepted after code review.