Neoclassical Programming Multitude
Unleash awesomeness. Private packages, team management tools, and powerful integrations. Get started with npm Orgs »


1.21.0 • Public • Published

Data Models

Build Status

Validation for standard data models

This repository provides examples and validators for data models that we want to share through different eHealth projects

JSON schema docs:

Attention developers!

This is open software. If you need realistic data for your tests you can either forge them or generate them automatically with the command line tool (see below). Improving the generator is also a way to improve the data model.

Schema Domain

Until such a time upon which we decide on something better, the current schema domain is and the current stable version is 1.0. e.g:



Add the dependency from the module, then use the provided validate method. For example if you want to validate a Person object:

var dataModel = require('data-models');
var person = { ... };
var errors = dataModel.validate(person);

If the object is valid, errors should be null.


Given an optional list of model names (and count), generate an instance with pre-filled pseudo data:

var dataModel = require('data-models');
dataModel.generate('driver', 1);
// =>
// { driver:
//   [ { doc_type: 'driver',
//       version: '1.0.0',
//       forename: 'Wade',
//       surname: 'Jacobi',
//       email: '',
//       phone: '1-264-961-1978' } ] }


A command line interface to the generate function (stringified as JSON) can be useful for generating fixtures, for example:

data-models --model driver --count 1


  "driver": [
      "doc_type": "driver",
      "version": "1.0.0",
      "forename": "Jeremie",
      "surname": "Bayer",
      "email": "",
      "phone": "(958) 420-7636 x656"

See data-model --help for further usage.

For client side code

A bundled version is available in the dist/ folder. The files there have been built with Browserify using the --standalone option, so they will expose a global dataModel object.

Remember to run npm run build before tagging a new release of this code in order to update the distribution files.


Copyright 2015 eHealth Africa

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License here.

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.


npm i data-models

Downloadsweekly downloads





Apache 2.0




last publish


  • avatar
Report a vulnerability