lib-marshal

marshalled object validation

Install

npm install --save lib-marshal

Usage

define your types

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

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))

parse incoming data

Validate an incoming object, or throw an error.

var message = messageProto.marshal(JSON.parse(str))

options

numbers

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>

strings

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>

untyped (json)

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'})

errors

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

see also

• lib-schema generate a marshaller from a json schema