et/src/et.coffee

effortlessness, et al.

Restify = require 'restify'

class Et

    constructor: -> 

        #
        # singleton (see module.exports below)
        # 

        @logger  = require './logger'
        @session = require './session'
        @model   = require './model'
        @auth    = require './auth'
        @static  = require './static'
        @route   = require './route'


    al: ( opts = {} ) ->

        console.log 'init et.al()'

        @resource = opts.resource

        et = this

        gotApp = opts.app != undefined

        opts.name ||= process.env.APP_NAME || 'untitled'
        opts.version ||= process.env.APP_VERSION || '0.0.0'
        opts.port ||= process.env.APP_PORT || 3000

        unless gotApp

            opts.app = Restify.createServer

                name: opts.name
                version: opts.version

            

        #
        # logger as first middleware
        #

        opts.app.use @logger.config this, opts


        #
        # first middleware in the et stack
        #
        # attach et instance to inbound request
        # and pass onward into the stack
        #

        @first = ( req, res, next ) -> 

            req.et = et
            next()

        opts.app.use @first




        @last = ( req, res, next ) -> 

            #
            # last middleware in the et stack
            #

            console.warn 'UNHANDLED request ', req.path 
            next()

        
        #
        # allows for middleware config (before session, auth, and model assembly)
        # by defining a callack in the opts as follows
        # 
        # et.al:
        #    before: (app) -> 
        #       app.use require 'my_middleware'
        #       app.use ...
        # 
        # NOTE: this is pre-authentication!!
        # 
        opts.before opts.app if opts.before instanceof Function


        @session.config this, opts
        @model.config this, opts
        @auth.config this, opts


        #
        # pre restify routing assignments middleware
        #
        opts.use opts.app if opts.use instanceof Function

        @static.config this, opts
        @route.config this, opts
        


        # #
        # # final middleware
        # #
        # opts.after opts.app if opts.final instanceof Function


        et.log.debug opts: opts

        if gotApp

            #
            # opts.app was defined
            # ie. Using an external 'connect' stack (eg. express)
            #

            return @last

        else
        
            #
            # TODO: Use useful configs on Restify.createServer()
            #       https://github.com/mcavage/node-restify
            #
            opts.app.listen opts.port
            # opts.app.listen opts.port, ->

            #     #
            #     # TODO: fix server ocassionally already closed()... (in specs)
            #     #       by the time opts.app.url attempts to get address.
            #     # 
            #     #       how to know if running test or live?
            #     # 

            #     console.log 'restify listening at %s', opts.app.url

        #
        # return the restify server
        #

        return opts.app


module.exports = new Et()  # singleton