A library for managing data in Node.js and web browsers.
Fortune.js is a library for managing data in Node.js and web browsers. It segregates data access, business logic, and external I/O, providing a baseline for interoperability and allowing each implementation to be swapped interchangeably.
View the website for documentation. Get it from
$ npm install fortune --save
Fortune.js has a minimal public interface, mostly just the constructor and
request method. Calling
request dispatches calls to three extensible interfaces that work together:
Serializer, and transform functions, based on the request data.
Adapterabstraction allows for multiple persistence back-ends, such as common server-side databases like Postgres and MongoDB, and IndexedDB in the web browser.
Serializerabstraction allows for multiple I/O formats, including media types such as Micro API and JSON API, standard input formats such as URL encoded and form data, and custom serializers for HTML.
Included are networking wrappers which call the
request method, so it is not coupled with any external protocol, and it should be able to work with any transport layer such as HTTP and WebSocket.
The only necessary input is record type definitions. Here's a model of a basic micro-blogging service:
const fortune = require'fortune'const store = fortuneuser:name: type: String// Following and followers are inversely related (many-to-many).following: link: 'user' inverse: 'followers' isArray: truefollowers: link: 'user' inverse: 'following' isArray: true// Many-to-one relationship of user posts to post author.posts: link: 'post' inverse: 'author' isArray: truepost:message: type: String// One-to-many relationship of post author to user posts.author: link: 'user' inverse: 'posts'
storerequesttype: 'user'method: 'create'payload: name: 'John Doe' name: 'Jane Doe'
The first call to
request will trigger a connection to the data store, and it returns the result as a Promise.
Then let's add a HTTP server:
const http = require'http'// The `fortune.net.http` helper function returns a listener function which// does content negotiation, and maps the internal response to a HTTP response.const server = httpcreateServerfortunenethttpstorestoreconnectthen => serverlisten1337
This yields an ad hoc JSON over HTTP API. There are serializers for Micro API (JSON-LD) and JSON API, which also accept HTTP parameters. In addition, Fortune.js implements a wire protocol based on WebSocket and MessagePack.
See the plugins page for more details.
Fortune.js is written in ECMAScript 5.1 syntax, with some ECMAScript 6 additions.
This software is licensed under the MIT license.