@ddoronin/super-object

super-object

$ yarn add @ddoronin/super-object

It's like Object.assign(), but even more.

Usage

Suppose you compose a request to upload a file. You decided to set different content types based on a file extension and apply gzip if this a javascript or css file.

import { compose } from 'super-object';
...
function createRequest(payload: any, fileExt: string) {
    return api.compose({
        body: { ...payload }
    }).if(fileExt === '.js', {
        contentType: 'text/javascript'
    }).elseif(fileExt === '.css', {
        contentType: 'text/css'
    }).else({
        contentType: 'application/octet-stream'
    }).if(fileExt === '.js' || fileExt === '.css', {
        encoding: 'gzip'
    }).val();
}

API

method	description
compose<A extends {}>(a: A = {} as any): IComposer<A>	Creates a wrapper around a given object a: A that is a context object.
append<B>(b: B): IComposer<A | B>	Appends a given object b to the context A
if<B>(condition: boolean, b: B): IComposer<A | B>	Appends a given object b to the context A if and only if the condition is satisfied.
elseif<C>(condition: boolean, c: C): IComposer<A | C>	Appends a given object c to the context A if and only if the condition is satisfied and a previous conditions were falsy.
else<D>(d: D): IComposer<A | D>	Appends a given object d to the context A if all previous conditions were falsy.
val(): A	Simply returns the context object A.

export interface IComposer<A> {

    append<B>(b: B): IComposer<A | B>;

    if<B>(condition: boolean, b: B): IComposer<A | B>;

    elseif<C>(condition: boolean, c: C): IComposer<A | C>

    else<D>(d: D): IComposer<A | D>;

    val(): A;
}

License

MIT