Type-safe utility library for creating nested Immutable Records
Immutable.js is a great library. Unfortunatelly, in v3 it does not support nested Records well, making its usability less pleasant.
The main purpose of this libary is to make our (my) life easier and reduce the amount of boilerplate code by providing a robust and typesafe wrapper around Immutable.Record class which initializes all other nested Immutable classes. It works like fromJS but for Record.
The following example shows a very basic use of compose-class using nested Records.
import { compose } from 'compose-record';
const Address = compose({
name: "Address",
properties: {
street: { type: String },
apt: { type: Number }
}
});
const Profile = compose({
name: "Profile",
properties: {
name: { type: String },
address: { type: Address }
}
});
const p = new Profile();
console.log(p.toJS());
/*
* {
* name: ''
* address: {
* street: '',
* apt: 0
* }
* }
* /All properties support custom default value. By default, these values are defined by their types.
import { compose } from 'compose-record';
const Address = compose({
name: "Address",
properties: {
street: { type: String },
apt: { type: Number }
}
});
const Profile = compose({
name: "Profile",
properties: {
name: {
type: String,
defaultValue: 'unknown'
},
address: {
type: Address,
defaultValue: {
street: 'unknown',
apt: -1
}
}
}
});
const p = new Profile();
console.log(p.toJS());
/*
* {
* name: 'unknown',
* address: {
* street: 'unknown',
* apt: -1
* }
* }
*/compose-record allows you to extend your Records with other(s).
import { compose } from 'compose-record';
const Entity = compose({
name: "Entity",
properties: {
id: { type: Number }
}
});
const User = compose({
name: "User",
extends: Entity,
properties: {
name: { type: String }
}
});
const u = new User();
console.log(p.toJS());
/*
* {
* id: 0,
* name: ''
* }
*/That all works fine with Record and primitive types. But what if we need to have a List or a Map with nested Records? compose-record has a special option for these: items.
items is a nested type descriptor that informs compose-record how to wrap the underlying values.
It's optional, by default compose-record will use a value as it is.
import { compose } from 'compose-record';
import { List } from 'immutable';
const User = compose({
name: 'User',
properties: {
name: { type: String }
}
});
const Group = compose({
name: 'Group',
properties: {
users: {
type: List,
items: {
type: User
}
}
}
});
const u = new Group({
users: [
{ name: 'Mike Wazowski' },
{ name: 'James P. Sullivan' }
]
});
console.log(p.toJS());
/*
* {
* users: [
* { name: 'Mike Wazowski' },
* { name: 'James P. Sullivan' }
* ]
* }
*/You can build even more complex scenarios:
import { compose } from 'compose-record';
import { List, Map } from 'immutable';
const User = compose({
name: 'User',
properties: {
name: { type: String }
}
});
const Group = compose({
name: 'Group',
properties: {
users: {
type: Map,
items: {
type: List,
items: {
type: User
}
}
}
}
});
const u = new Group({
users: {
monsters: [
{ name: 'Mike Wazowski' },
{ name: 'James P. Sullivan' }
],
humans: [
{ name: 'Boo' }
]
}
});
console.log(p.toJS());
/*
* {
* users: {
* monsters: [
* { name: 'Mike Wazowski' },
* { name: 'James P. Sullivan' }
* ],
* humans: [
* { name: 'Boo' }
* ]
* }
* }
*/Note: There is one caveat: It works only for constructors. All further inserts require you to pass an instance of a nested Record. This is a limiation of compose-record which might be solved in the future.
Current work around is to get a type descriptor and use Record.createPropertyInstance() method:
import { compose } from 'compose-record';
import { List, Map } from 'immutable';
const User = compose({
name: 'User',
properties: {
name: {
type: String,
},
},
});
const Group = compose({
name: 'Group',
properties: {
users: {
type: List,
items: {
type: User,
},
},
},
});
const desc = Group.getPropertyDescriptors();
const u = Group.createPropertyInstance<User>(desc.users.items, {
name: 'Mike Wazowski',
});
const g = new Group();
console.log(g.users.push(u).toJS());
/*
* {
* users: [
* { name: 'Mike Wazowski' },
* ]
* }
*/