@ze-ts/composition

This package provides a set of utilities to help you compose your functions in a more readable and functional way.

Installation

1npm install @ze-ts/composition

Usage

pipe

Pipe is a function with arity n that the first argument is a value and the rest are functions that will be applied to the value in sequence.

Signature

1pipe: (value: any, ...fns: Function[]) => any;

Example

1import { pipe } from '@ze-ts/composition';
2
3const add = (a: number) => (b: number) => a + b;
4const multiply = (a: number) => (b: number) => a * b;
5
6const result = pipe(5, add(3), multiply(2));
7
8console.log(result); // 16

flow

Flow is a function with arity n that takes a list of functions and returns a new function that receives a value and applies the functions in sequence.

Signature

1flow: (...fns: Function[]) =>
2  (value: any) =>
3    any;

Example

1import { flow } from '@ze-ts/composition';
2
3const add = (a: number) => (b: number) => a + b;
4const multiply = (a: number) => (b: number) => a * b;
5
6const addAndMultiply = flow(add(3), multiply(2));
7
8addAndMultiply(2); // 10

compose

Compose is a function with arity n that takes a list of functions and returns a new function that receives a value and applies the functions in reverse order (rigth-to-left).

Signature

1// fns will be applied in reverse order
2compose: (...fns: Function[]) =>
3  (value: any) =>
4    any;

Example

1import { compose } from '@ze-ts/composition';
2
3const add = (a: number) => (b: number) => a + b;
4const multiply = (a: number) => (b: number) => a * b;
5
6const addAndMultiply = compose(multiply(2), add(3));
7
8addAndMultiply(2); // 10