freddies

The Zero-Dependency Left-To-Right Function Composer!

What's A "Freddy"?

That's a term I just made up for a process defined as array of functions!

...it also comes from Function-Reducible Array

Show Me!

Don't Do This:

// NO! Pyramid of DOOM! Reversed Process Order!
const foo = doLastThing(
                doThirdThing(
                    doSecondThing(
                        doFirstThing(a, b, c)
                    )
                )
           );

Do This Instead!

// YES! Freddies are defined as ordered steps!
const myFreddy = [
    doFirstThing, 
    doSecondThing, 
    doThirdThing, 
    doLastThing
];
 
// Freddy to function!
const doSomeThings = f(myFreddy);
 
// And done!
const foo = doSomeThings(a, b, c);

Or Even Skip the Explicit Array Declaration!

const doSomeThings = f(
    doFirstThing, 
    doSecondThing, 
    doThirdThing, 
    doLastThing
);
 
const foo = doSomeThings(a, b, c);

Got An Async Process?

Freddies understand promises!

const findUserByName = (name) => { 
    return db.users.findOne({name}) 
};
 
const activateUser   = (user) => {
    user.activated = true;
    return user;
};
 
// Freddy to function!
const activateByName = f(findUserByName, activateUser, db.users.update);
 
// Invoke and catch errors like usual
activateByName('Fred').catch(errorHandler);
 

Got a Complex Multi-Stage Process?

Freddies can contain other freddies!

const access = [readSession, checkPermissions ]
const sanitizeForm = [ sanitizeXss, sanitizeSqlInject ]
const validateForm = [ checkNonce, validateComment]
const clean  = [sanitizeForm, validateForm];
// clearly-defined flow 
on('add-comment', f(
    access,
    clean,
    db.comments.insert,
    respondOk
)).catch(respondWithError);
 

Shut up and take my money!

Installation (npm):

npm install --save freddies

For the import-ers:

import f from 'freddies';

For the require-ers:

var f = require('freddies').default;