❤
npm
Sign UpSign In

lib-marshal

0.8.0 • Public • Published

lib-marshal

marshalled object validation

Build Status

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

Readme

Keywords

none

Package Sidebar

Install

npm i lib-marshal

Repository

github.com/groundwater/node-lib-marshal

Homepage

github.com/groundwater/node-lib-marshal

Weekly Downloads

5

Version

0.8.0

License

ISC

Last publish

Collaborators

  • groundwater
Try on RunKit
Report malware