1.0.0-rc.4 • Public • Published


    Build status npm version MIT License

    Node.js abstraction layer and automation framework.


    The basic idea behind abstractor is that more or less standardised messages is passed between nodes to form an application.


    A message normally consist of a topic and a payload, but can have any number of additional attributes depending on which node it has passed, or will pass.

    When writing simple applications, you won't have to fiddle with messages manually. They will silently pass between the nodes you set up.

    As an example, a message originating from the MQTT-node will look something like this ...

        topic: "indoor/livingroom/roof/lights",
        payload: "on",
        qos: 2,
        retain: false

    ... and a message on it's way to the file-write node will look like this ...

        path: "~/abstractor.log",
        flag: "a",  // "a" == append, "w" == overwrite
        payload: "This will be appended to abstractor.log"

    Both path and flag can be set at node level too, see next section.


    Nodes are essentially customized functions, which are designed to execute a specific task as efficiently and transparent as possible.

    Some nodes can both receive and emit messages. One such example is the json node, which converts the payload to a json string if it is a javascript object and vice versa.

    The nodes connect to each other through pre-defined events, most nodes emit "success" or "failure" on completion. See the documentation for information on what each node can emit.


    To put it all together, an example that continously tail a file on changes and output the last 10 rows to the console.

        // Initialize abstractor
        abstractor = require("abstractor"),
        // Create node factory
        factory = abstractor()
        // Create nodes
        // - Create instance of file-watch node, tell the node to monitor `/var/log/syslog`
        //   This node will emit "success" every time the file changes
        watchNode =  factory( "file-watch", { path: '/var/log/syslog' }),
        // - Create a file-read node, tell it to only read the last 10 rows.
        //   On completion, "success" will be emitted.
        readNode =  factory( "file-read", { tail: 10 }),
        // - In this example, we create a generic node (function wrapper) that just print the payload
        //   to the console.
        outputNode =  factory( "generic", function (msg) { console.log(msg.payload); });
    // Ok, the building blocks is ready, we just got to stack them up.
    watchNode.on("success", readNode);
    readNode.on("success", outputNode);

    More examples available at /examples


    The simplest way to get Abstractor is through npm. Simply run the following in your command line from your project folder.

    npm install abstractor


    Abstractor itself has very few dependencies. However, certain embedded modules dynamically includes third party libraries. As an example, The telldus modules need http://github.com/hexagon/telldus to work.

    The framework will raise an run time error if it is missing an dependency.



    The logger has 5 levels of verbosity

    • 0 = Silent
    • 1 = adds errors
    • 2 = adds warnings
    • 3 = adds logs
    • 4 = adds notices (default)
    • 5 = adds full message for each invoke

    Default mode (4) outputs a timestamped log everytime a node triggers a message.

        // Initialize abstractor
        factory = require('abstractor')({logLevel: 4}),
    // ...

    Will result in something like ...

    [2016-10-02 21:50:12] CORE > Abstractor ready
    [2016-10-02 21:50:12] CORE > Imported node json on the fly.
    [2016-10-02 21:50:12] CORE > Imported node file-write on the fly.
    [2016-10-02 21:50:12] CORE > Imported node file-read on the fly.
    [2016-10-02 21:50:12] JSON > success
    [2016-10-02 21:50:12] FILEWRITE > success

    For more; see examples/ folder.


    Below is just a brief description of each of the nodes. For in-depth documentation, see the source files at /lib/nodes/.

    Built in nodes


    In memory key/value storage, great for storing the last payload of a specific topic.

    more ...


    Competent cron-like scheduler based on croner (github.com/hexagon/croner)

    more ...

    Related examples:


    CSV parser and generator. Parser uses fast-csv.

    If input payload is an array width objects, the contained objects are converted to CSV rows.

    If input payload is a string, the string is parsed to an array of objects.

    more ...


    Waits for x milliseconds before passing the message.

    more ...


    Executes a command, returns exit code, stdout and stderr.

    more ...

    Related examples:


    Reads a file, capable of reading first/last x rows and first/last x characters.

    more ...

    Related examples:


    Watches a file for changes, emits a message on change.

    more ...

    Related examples:


    Writes payload (string/buffer) to a file, encoding and flag are configurable.

    Possible flags: a = append w = overwrite

    more ...

    Related examples:


    Converts a regular function to a abstractor node.

    more ...

    Related examples:


    Monitors the frequency of messages received, outputs "timeout" when no message has arrived in x ms.

    more ...

    Related examples:

    HTML Parser

    Parses the payload HTML and outputs an object representing the html.

    The get-parameter can contain any of these: object - Object representation of the selected element attribute - Gets the value of a specific attribute (specified by attribute option) value - Value of certain nodes (input, textarea select) text - Text contained in selected element html - ? array - Array of objects representing matched elements

    more ...

    HTTP Client

    Gets the response code, body and response headers from an url. Does follow redirects.

    more ...

    HTTP Server

    Simple HTTP server, triggers both "request" and "/requested/url" on incoming requests.


    Listen on all requests

    httpNode.on("request", handlerNode); // Receive message, pass to handler
    handlerNode.on("success", httpNode); // Handle message, pass back

    Listen on request to /api/enable/lamp

    httpNode.on("/api/enable/lamp", handlerNode);

    Listen on requests to /api//on

    httpNode.on("/api/:device/on", handlerNode);

    In this case, handlerNode need to be a generic function that takes an extra parameter (the wildcard).

    requestHandler = flow( "generic", function(msg, device) { 
        msg.payload = 'turning on ' + device;
        return msg;  

    The server responds to a request when it gets the message back. See first example above.

    more ...

    Related examples:


    JSON parser and stringifier. When feeded with an object, payload is stringified to JSON and vice versa.

    more ...

    Related examples:


    Emits messages with incoming topic as event name.

        topic: "hellu", 
        payload: <data>

    Will be passed with

    junctionNode.on( "hellu", <receiver> );

    more ...

    Related examples:


    Kills the current process when receiving a message. Exit code is configurable through node config (exitCode), or through message property (also exitCode).

    more ...


    Sends mail using nodemailer. Options are passed as is, see:


    more ...


    Replaces the values of configured column in a dataset with another value.

    The first time the node is invoked, it expects a map (key-valye object or array of key->value arrays) to be passed as message.payload.

    more ...


    Subscribe to topics, and send messages to a MQTT network. Supports setting/getting qos and retain flag.

    more ...

    Related examples:


    Query can be set with .query OR msg.query OR msg.topic, prioritized in that order.

    Parameters can be set with .parameters OR msg.parameters.

    { topic: "SELECT @mystring as greeting, * FROM table WHERE id = @id", parameters: { id: 1531512, mystring: "Hellu" } }

    more ...


    MySQL client node.

    Query can be set with .query OR msg.query OR msg.topic, prioritized in that order.

    Parameters can be set with .parameters OR msg.parameters.

    { topic: "SELECT :mystring as greeting, * FROM table WHERE id = :id", parameters: { id: 1531512, mystring: "Hellu" } }

    more ...


    Very simple node that clear process.exitCode and emit success.

    Useful when you need to retry an action that have emitted error.

    Number of retry is set in node config

    // ...
    delay = f( "delay", { delay: 5000 });
    retry = f( "retry", { retries: 5 }s);
    // ...
    // If MySQL emit error, retry after 5 seconds
          delay.on("success", mysql)));

    more ...


    Splits an incoming array and emits one separate "item" message per item.

    more ...

    Related examples:


    Removed unwanted properties before apssing the message firther.

    more ...


    Emits a message on sun events.

    Possible triggers:

    • sunrise
    • sunset
    • dusk
    • night
    • dawn

    more ...

    Related examples:

    Telldus device

    Listens for status changes, and sets status of a configured telldus device.

    more ...

    Telldus sensor

    Listens for sensor updates in telldus network.

    more ...


    Dynamic template module using version 2 of ant.

    This module allows for {{ message.payload }}, and also {{# js code }}. The full message is accessible within template through message.property.

    Template can be set either through node config.template, or message.template.

    Example template:

    Welcome, {{ message.name }}!
    {{# message.payload.forEach(function(link) { }}
    	<li><a href="{{ link.url }}">{{ link.text }} </a></li>
    {{# } }}

    more (@github.com/unkelpehr/ant) ...

    Related examples:

    Websocket Server

    Simple WS server.

    more ...

    Related examples:

    Websocket Client

    Reconnecting websocket client.

    more ...

    Related examples:


    Synchronous message queue.

    Passes next message by emitting "item" when the previous has returned. Emits "drained" whenever queue becomes empty.

    The default is to process the queue synchronously, is is however possible to allow concurrency by increasing "concurrency" option above the default of 1.

    more ...

    Related examples:

    Third party nodes

    It's up to you, see lib/modules/ for inspiration.




    npm i abstractor

    DownloadsWeekly Downloads






    Last publish


    • hexagon