lib-marshal

marshalled object validation

lib-marshal

marshalled object validation

npm install --save lib-marshal
var marshal = require('lib-marshal');
 
// define some types 
var stringProto  = new marshal.StringType;
var messageProto = new marshal.StructType;
 
messageProto.add('from'   , stringProto);
messageProto.add('dest'   , stringProto);
messageProto.add('body'   , stringProto);
messageProto.add('subject', stringProto);

Prepare data for the client, by stripping out unused properties and validating data types.

// create a data object 
var m = {
  from: 'bob',
  dest: 'kim',
  body: 'hello world'
};
 
// ready it for the world, or die trying 
JSON.stringify(messageProto.marshal(m))

Validate an incoming object, or throw an error.

var message = messageProto.marshal(JSON.parse(str))
var num = new NumberType({max: 10, min: 0})
 
num.marshal(-1)
// Error: Value <-1> must be greater than 0 at <var> 
 
num.marshal(20)
// Error: Value <20> must be less than 10 at <var> 
var str = new StringType({min: 1, max: 20, match: /.@.\../})
 
str.marshal('bob AT aol.com')
// Error: Value <bob AT aol.com> must be match the pattern </.@.\../> at <var> 

If you're not ready for a schema yet, you can allow arbitrary data with the JsonType type

var type = new JsonType()
var json = type.marshal({one: 1, two: 'two'})

Handy dandy error messages

var message = new StructType;
var address = new StructType;
var content = new StructType;
 
content.add('subject', new StringType)
content.add('body', new StringType)
content.add('author', address)
 
address.add('name', new StringType)
address.add('email', new StringType)
 
message.add('from', address)
message.add('to', address)
message.add('content', content)
 
message.marshal({
  to: {
    name    : "Kim",
    email   : "kim@outer.space"
  },
  from      : {
    name    : "Bob",
    email   : "bob@outer.space"
  },
  content   : {
    body    : "This is a test",
    subject : "Hello World",
    author  : "Bob"
  }
});

You'll receive a helpful error when things fail to parse

Error: Expected <object> but Received "Bob" of type <string> at <var>.content.author
  • lib-schema generate a marshaller from a json schema