Feature(MapSingleObject): Allows to map on a single object instead of collection only

[emyann]

No breaking changes. Full backward compatible with previous versions.

Single Object Mapping

Allows to map a single object instead of collection only. The output dimension is the same as the input dimension.

To map an object, or collection before

let source = {...};
let object = Morphism(schema, [source])[0];

// Iterate on collection and map
collection.map(item => Morphism(schema,[item])[0];

To map an object, or collection now

let source = {...};
let object = Morphism(schema, source);
// → {...} output is an object

let sources = [{...}, {...}];
let ouput = Morphism(schema, sources);
// → [] output is a collection

let output = Morphism.map(Type, []);
// →Type[] output is a collection of Type

let output = Morphism.map(Type, {});
// →Type{} output is a Type object

Make low level and typed mappers functions iteratee first:

now it's possible to do:

map over a Low Level mapper (schema applied on plain objects)

let collection = [{...}, {...}];
let results = collection.map(Morphism(schema));

let collection = [{...}];
const mapper = Morphism(schema);
let results = collection.map(mapper);

map over a Typed mapper (schema applied on Type)

let collection = [{...}, {...}];
class Type {}
let mapper = Morphism.register(Type);
let results = collection.map(mapper);

let collection = [{...}, {...}];
class Type {}
let results = collection.map(Morphism.map(Type));

Misc

• Add defensive programming on undefined input
• Properly rethrows Exception inside call function
• Refactoring and JsDoc
• Bunch of Unit Tests
  Closes Unable to use source properties aggregation along with a computing function #8

[coveralls]

Coverage remained the same at 100.0% when pulling 4a476a5 on feature/Map-Single-Object-And-Refactoring into df023b7 on master.

[emyann]

@ludovicthomas This PR might interest you. I improved usability as already discussed. Tested with our Falcor implementation, it's fully backward compatible. No need for a review but I won't refuse a pass if you have some time :)

[coveralls]

Coverage remained the same at 100.0% when pulling 2499f0c on feature/Map-Single-Object-And-Refactoring into df023b7 on master.

[coveralls]

Coverage remained the same at 100.0% when pulling 2499f0c on feature/Map-Single-Object-And-Refactoring into df023b7 on master.

[ludovicthomas]

Sorry for late feedback. Nice work! Thanks for the update.