overloaded client.end

[brianc]

ability to pass true to client.end to have the method wait until the client's internal query queue is emptied before disconnection

client.query('alskdjf')
client.end() //disconnects before query is finished

versus

client.query('lkajsdf');
client.end(true) //disconnects once query is finished

[kaiko]

I created this (for me, callback was really needed because other modules closing was depending on database finish):

PGClient.prototype.safeEnd = function (callback) {
    var me = this, realEnd = function () { me.end(); callback(); }

    if (this.readyForQuery && this.queryQueue.length === 0) realEnd();
    else this.on('drain', realEnd);
}

[brianc]

now calling pg.end on the connection pool will wait until all pending queries are finished in each client before terminating each client. I think having the client object itself's 'end' method do an immediate shutdown is consistent with the rest of node's APIs.