flatulence

Flatten objects and arrays into non-nested objects and arrays.
A flattened object consists of key paths pointing to primitive values.
Paths are lodash-compatible so they can be used with _.set() and _.get().

Unflatten flattened objects and make them regular, nested JS objects again.

``javascript
const flatulence = require('flatulence')


// Create a flat object
const flattened = flatulence.flatten({
a: 1,
b: {
c: 1,
d: [1,2,3]
}
})
// {
// a: 1,
// 'b.c': 1,
// 'b.d[0]': 1,
// 'b.d[1]': 2,
// 'b.d[2]': 3
// }


// Optionally you can decide to keep empty arrays and objects
const flattened = fl.flatten.keepEmpty({
"name": "Mega Group 2",
"loginId": "admin_mega_merchant_2",
"description": "again, some description here",
"merchantUsers": [],
"map": {}
})
//
// {
// name: 'Mega Group 2',
// loginId: 'admin_mega_merchant_2',
// description: 'again, some description here',
// merchantUsers: [],
// map: {}
// }


// Create a flat object and provide a prefix to each key
var flattened2 = flatulence.flatten(
{ a: 1, b: { c: 1, d: [ 1, 2, 3 ] } },
'my.prefix.key'
)
//{
// 'my.prefix.key.a': 1,
// 'my.prefix.key.b.c': 1,
// 'my.prefix.key.b.d[0]': 1,
// 'my.prefix.key.b.d[1]': 2,
// 'my.prefix.key.b.d[2]': 3
//}


const regular = flatulence.unflatten(flattened)
// { a: 1, b: { c: 1, d: [ 1, 2, 3 ] } }

// Only unflatten a sub object
const b = flatulence.unflatten(flattened, 'b')
// { c: 1, d: [ 1, 2, 3 ] }

// Sub objects can even be arrays
const array = flatulence.unflatten(flattened, 'b.d')
// [ 1, 2, 3 ]
``