Skip to main content
Version: 6.5

Schema Quick Start

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

{
"id": "123",
"author": {
"id": "1",
"name": "Paul"
},
"title": "My awesome blog post",
"comments": [
{
"id": "324",
"createdAt": "2013-05-29T00:00:00-04:00",
"commenter": {
"id": "2",
"name": "Nicole"
}
}
]
}

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

import { normalize, schema, Entity } from '@rest-hooks/normalizr';

// Define a users schema
class User extends Entity {
id = '';
name = '';

pk() { return this.id; }
}

// Define your comments schema
class Comment extends Entity {
id = '';
createdAt = new Date(0);
commenter = User.fromJS({});

pk() { return this.id; }

static schema = {
commenter: User,
createdAt: Date,
}
}

// Define your article
class Article extends Entity {
id = '';
title = '';
author = User.fromJS({});
comments: Comment[] = [];

pk() { return this.id; }

static schema = {
author: User,
comments: [Comment],
}
}

const normalizedData = normalize(originalData, article);

Now, normalizedData will be:

{
result: "123",
entities: {
"articles": Article {
"123": {
id: "123",
author: "1",
title: "My awesome blog post",
comments: [ "324" ]
}
},
"users": {
"1": User { "id": "1", "name": "Paul" },
"2": User { "id": "2", "name": "Nicole" }
},
"comments": {
"324": Comment {
id: "324",
"createdAt": Date(`May 29, 2013`),
"commenter": "2"
}
}
}
}