scrubbr

Scrubbr

Serialize JSON data using TypeScript.

Serializing data sent from the webserver to the client shouldn't be hard. If you're already using TypeScript, you have everything you need. Scrubbr will use your TypeScript types to deeply transform and sanitize your data.

Documentation

Install

npm i -S scrubbr

Quick Start

The simplest example is to filter out sensitive data.

In this example we want to filter the email and password out of this sample data:

{
  users: [
    {
      name: 'John Doe',
      image: 'http://i.pravatar.cc/300',
      email: '[e-mail]',
      password: 'xxxsecretxxx',
    },
  ],
};

1. Define a TypeScript file as your master schema:

// schema.ts

type UserList = {
  users: User[];
};

type User = {
  name: string;
  image: string;
};

1. Load it into Scrubbr and serialize your data:

import Scrubbr from 'scrubbr';

// PERFORMANCE NOTE: this is a synchronous call!
// Load early and cache to a shared variable.
const scrubbr = new Scrubbr('./schema.ts');

async function api() {
  const data = getUsers();

  // Serialize the data based on the UserList type defined in schema.ts
  return await scrubbr.serialize('UserList', data);
}

1. Ouput

{
  "users": [
    {
      "name": "John Doe",
      "image": "http://i.pravatar.cc/300"
    }
  ]
}

Documentation

Read the documentation to learn how do do more with Scrubbr.

License

MIT