normalizr-ts

Normalizr-ts is a complet & simple typescript rewrite of normalizr (normalization only for now). The library support the Typescript Class normalization. All tests normalization test specs from normalizr was ported.

Install

Install from the NPM repository using yarn or npm:

1yarn add @nakama.d/normalizr-ts

1npm install @nakama.d/normalizr-ts

Documentation

• API
  • Normalizer
  • EntitySchema

Examples

• Normalizing GitHub Issues
• Relational Data
• Interactive Redux

Quick Start

Consider a typical blog post. The API response for a single post might look something like this:

1{
2  "id": "123",
3  "author": {
4    "id": "1",
5    "name": "Paul"
6  },
7  "title": "My awesome blog post",
8  "comments": [
9    {
10      "id": "324",
11      "commenter": {
12        "id": "2",
13        "name": "Nicole"
14      }
15    }
16  ]
17}

We have two nested entity types within our article: users and comments. Using various schema, we can normalize all three entity types down:

1import { EntitySchema, Normalizer } from '@nakama.d/normalizr-ts'
2
3// Define a users schema
4const user = new EntitySchema('users')
5
6// Define your comments schema
7const comment = new EntitySchema('comments', {
8  relations: { commenter: user }
9})
10
11// Define your article
12const article = new EntitySchema('articles', {
13  relations: { 
14    author: user,
15    comments: [comment]
16  }
17})
18
19const normalizer = new Normalizer([user, comment, article])
20const normalizedData = normalizer.normalize(inputs, 'articles')

Now, normalizedData will be:

1{
2  result: "123",
3  entities: {
4    "articles": {
5      "123": {
6        id: "123",
7        author: "1",
8        title: "My awesome blog post",
9        comments: [ "324" ]
10      }
11    },
12    "users": {
13      "1": { "id": "1", "name": "Paul" },
14      "2": { "id": "2", "name": "Nicole" }
15    },
16    "comments": {
17      "324": { id: "324", "commenter": "2" }
18    }
19  }
20}

With Class

1import { EntitySchema, Normalizer } from '@nakama.d/normalizr-ts'
2
3class User {...}
4class Comment {...}
5class Article {...}
6
7// Define a users schema
8const user = new EntitySchema('users', { entityClass: User })
9
10// Define your comments schema
11const comment = new EntitySchema('comments', {
12  entityClass: Comment,
13  relations: { commenter: user }
14})
15
16// Define your article
17const article = new EntitySchema('articles', {
18  entityClass: Article,
19  relations: { 
20    author: user,
21    comments: [comment]
22  }
23})
24
25const normalizer = new Normalizer([user, comment, article])
26const normalizedData = normalizer.normalize(inputs, 'articles')

Now, normalizedData will have all entities to be instance of entity Class.

TODO

• Mode docs
• De nomalized method?

Credits

Normalizr-ts was inspired by Normalizr maintained by Paul Armstrong