cogs-pubsub-dialect

Cogswell Pub-Sub Dialect

This package is a collection of JavaScript object validators to validate cogswell pub-sub request/response objects. This package uses the Joi library for validation.

Pub/Sub JSON Dialect

The dialect definition can be found at the Pub/Sub Dialect page.

Usage

const validators = require('cogs-pubsub-dialect');
 
const exampleObject = {
  sequence: 12345,
  code: 404,
  message: 'Not Found',
  details: 'There are no subscribers to the specified channel, so the message could not be delivered.'
}
 
//without callback
const result = validators.validate(exampleObject, validators.publish.noSubscriptionsError);
result == {err: null, value: exampleObject}; //true
 
//with callback
const result = validators.validate(exampleObject, validators.publish.noSubscriptionsError, function(err, value) {
  err == null; //true
  //value will not necessarily equal the original object, for example, if Joi validates a date,
  //it will also parse it into a JS date object
});
 
//the validate function is a direct alias to Joi's validate therefore you can do this (or the callback version):
const result = Joi.validate(exampleObject, validators.publish.noSubscriptionsError);
result == {err: null, value: exampleObject}; //true

Validators

Use the following validators to validate their respective objects

• general

  • catchAllError
  • invalidFormatError

• subscribe

  • directive
  • success
  • incorrectPermissionsError

• unsubscribe

  • directive
  • success
  • incorrectPermissionsError
  • notFoundError

• publish

  • directive
  • incorrectPermissionsError
  • noSubscriptionsError

• message

Testing

To run the unit tests, run the following command

npm test