The Client Library for LargeMouth BAAS
##Motivation Firebase is a Backend As A Service (BAAS) which allows developers to quickly build applications without worrying about the communication layer between the server and client. Firebase is awesome but the backend remains entirely proprietary. LargeMouth / SmallMouth attempt to recreate the Firebase api as an open-source project. Idealy a Firebase app could be easily moved to SmallMouth and vice versa.
bower install smallmouth
##Example ###Creating Resources Create a new resource just as you would with FireBase, except make the server referenced is a running instance of LargeMouth.
var chats = '';// If the defaultHost is defined, the following statement is equivalent to the previous.SmallMouthdefaultHost = "";chats = '/chats';
SmallMouth aggresively stores content within local storage on the client. As resources are created and data is saved, initially everything is stored locally before being saved to the server. Because all data is stored locally on the client, SmallMouth can be used as an entirely clientside store (note make sure a modern browser is used). Create a client side data structure by not including a server when instantiating a new resource:
var chats = '/chats';chatson'value'console.logsnapshotval;;
See a more complete example with AngularJS. ##Release notes
- v0.3.2 - Add a default host option allowing declarations not to include the host.
- v0.3.1 - Add an adapter for communicating with native websockets rather than a wrapper library. Also convenience methods for switching between adapters - SmallMouth.getAvailableAdapters() SmallMouth.setSocketAdapter(SmallMouth.getAvailableAdapters()).
- v0.3.0 - Implement basic security and the remove method.
- v0.2.4 - Add a method SmallMouth.Resource.postMessage(type, data) and SmallMouth.postMessage(host, type, data) to send custom messages to the server. See LargeMouth's documentation for how to register custom event listeners.
- v0.2.3 - Refactor the EventRegistry into a class. For event listener callback functions, the second parameter is now an options object which currently is only passed whether or not the data is from the local or remote registry, egs.
- v0.2.1 - Fix sockjs implementation to queue events to send once the connection is finally made
- v0.2.0 - Support connecting to multiple backend hosts (create separate data registries for each host). Support multiple types of socket architectures (socket.io and sockjs).
- v0.1.11 - Support a minimal portion of the Firebase API with the following resource methods: on, off, set, update, remove, push, child, parent, root, name, toString. Support the following snapshot methods: val, child, forEach, hasChild, hasChildren, name, numChildren, ref
##Road map LargeMouth is under active development with the following roadmap. If interested in contributing, please fork the project!
- Build the security layers
- Implement a database layer for MongoJS and LevelDB (currently the project is entirely in-memory)
- Build a plugin api
- Allow for custom defining custom events