🍪 cookiejar

Unofficial Bower registry with RethinkDB and elasticsearch

cookiejar rebuilds the Bower registry by using RethinkDB as main database and automatic replication to elasticsearch. Only relevant data is indexed and all actions on Rethink are mirrored to elastic. Adding elasticsearch to the stack makes search and analytics easier and more reliable. Cookiejar is built modular and allows different workers to provide the actual data, while providing an easy to use API, which clients can interact with.

Requirements

rethink DB 2.2.2
elasticsearch 2.1.0

Using cookiejar

• run RethinkDB
• run elasticsearch
• run /init to populate the DBs
• use cookiemonster to query the database
• enjoy cookies 🍪

Populating

The route /init will populate your databases with the included dataset in /data. You can always populate with newer data by fetching $ curl http://bower.herokuapp.com/packages and using that JSON.

Querying the registry 🔎

Cookiejar uses Netflix' Falcor to hide different routes behind one single endpoint. Every request to the database is then internally routed by Falcor and returns an on-the-fly generated JSON Graph. This means all client-side communication goes through one route like this:

var model = new falcor.Model({source: new falcor.HttpDataSource('http://registry.com/model.json') });

To communicate with the registry, you can use the following functions, provided by the endpoint:

⭕ registryInfo

model.get("registryInfo").then(function(response) {
  document.write(response.json.registryInfo.version);
});

⭕ packages.length

model.get("packages.length").then(function(response) {
  document.write(response.json.packages.length);
});

⭕ packages

model.get(["packages", "bower"]).then(function(response) {
  var res = response.json.packagesByName.bower;
  for (pack in res) {
    document.write(res[pack].name+" - "+res[pack].url+"<br>");
  }       
});

⭕ packages.create

model.call(["packages", "create", "bower", "git://github.com/BenMann/testrepo"]).then(function(response){        
  document.write(response.json.createPackage.test123["git://github.com/BenMann/testrepo"]);
});

⭕ packages.remove

model.call(["packages", "remove", "bower"]).then(function(response){        
  document.write(response.json.createPackage.test123["git://github.com/BenMann/testrepo"]);
});

Internal use: :o: packageById

model.get(["packageById", "4J_wSnMIbr8x", "url"]).then(function(response) {
  document.write(response.json.packageById["4J_wSnMIbr8x"].url);
});

-- Here's a good start if you'd like to contribute!