Robert on Asus 305 bc66e4bc3c Samples: Subscriptions.

Subscribe to all events & subscribe to all events, catching up from the beginning.

2016-11-01 08:20:39 -07:00

3.0 KiB

Raw Blame History

eventstore-node

A port of the EventStore .Net ClientAPI to Node.js

Dependencies

Node.js >= 0.12
Modules: long, protobufjs, uuid (installed via npm install)

Status

Unstable

Missing features:

Ssl connection
Cluster connection
Set system settings

Incomplete

Typed errors: currently most errors are direct instance of Error, which is not practical for error handling
Performance: there's still some while loop in the code that could be problematic with node.js
Tests: tests are only covering happy path scenarios for now

Getting started

Install & run Eventstore on localhost

See http://docs.geteventstore.com/introduction/3.9.0/ .

Example: Storing an event

Save to app.js:

var esClient = require('eventstore-node');
var uuid = require('uuid');

var streamName = "testStream";
var esConnection = esClient.createConnection({}, {"hostname": "localhost", "port": 1113});
esConnection.connect();
esConnection.once('connected', function (tcpEndPoint) {
    console.log('Connected to eventstore at ' + tcpEndPoint.hostname + ":" + tcpEndPoint.port);
});

var eventId = uuid.v4();
var eventData = {
    a : Math.random(), 
    b: uuid.v4()
};
var event = esClient.createJsonEventData(eventId, eventData, null, 'testEvent');
console.log("Appending...");
esConnection.appendToStream(streamName, esClient.expectedVersion.any, event)
    .then(function(result) {
        console.log("Stored event:", eventId);
        console.log("Look for it at: http://localhost:2113/web/index.html#/streams/testStream");
        esConnection.close();
    })
    .catch(function(err) {
        console.log(err);
    });

Run:

npm install uuid
npm install eventstore-node
node app.js

Example: Subscribing to events

cd samples

To subscribe to all events from now on (includes example of a filter which ignores events which we aren't interested in):

node subscribe-all-events.js

To catch up on all events ever and subscribe to all new ones from now on:

node subscribe-catchup-all-events.js

To generate a test event, open a separate console and run:

node store-event.js

Running the tests

To run the tests you will need

To install the dependencies (npm install)
Run an instance of EventStore >= 3.3.0 (competing consumers are required for test) on localhost:1113 (Download here)

To execute the tests suites simply run test with npm

npm test

Porting .Net Task to Node.js

.Net Task have been replace with Promise. When executing an async command, i.e. appendToStream you can use then/catch to wait for result/error.

License

Ported code is released under the MIT license, see LICENSE.

Original code is released under the EventStore license and can be found at https://github.com/eventstore/eventstore.

3.0 KiB Raw Blame History