dagger

Dagger is one half of a minimal API server layer for node.js, with emphasis on minimal.

** Alpha, use at your own risk **

Dagger is the backend of a minimal web API server for rapidly prototyping super-lightweight node.js services.

Dagger offers:

  • The ability to rapidly develop web APIs and flexibly integrate services of all types in minimal time.
  • An incredibly tight end product. None of the dependency bloat or slow startup of Express.js
  • Predictability, readability and maintainability of its code.

Express and other web frameworks encourage anti-patterns like the Connect-style responder chain, which distributes portions of the request-parsing and response-generating code into vastly different (sometimes opaque) places in your source and decreases predictability (and maintainability.) Dagger is totally focused on making the HTTP request-response paradigm straightforward, even in the most complex cases. Nobody modifies the request or messes with the response but you.

npm install dagger
var server = new Dagger.Server(     {   "/":        homeServer,
                                        "static":   staticServer,
                                        "api":      new Dagger.Router(
                                                    {
                                                        "/users": Dagger.APIEndpoint(users.getAll, users),
                                                        "/users/:username": Dagger.APIEndpoint(users.getByName, users),
                                                    }),
                                    },
                                    8000
                                );

function getAll(request, response, args, callback)
{
    storageLayer.users.all(function(err, users)
    {
        if(err)
            return(callback(undefined, 500));   //return HTTP 500 and no data
        
        if(users.length == 0)
            return(callback([], 404));  //return HTTP 404 and an empty list

        callback(users);    //returning HTTP 200 is the default
    });
}

function getByName(request, response, args, callback)
{
    storageLayer.users.some({name: args.url.username}, function(err, user)
    {
        if(err)
            return(callback(undefined, 500));   //return HTTP 500 and no data
        
        callback(user);
    }
}