stacks 0.0.9 → 0.37.3

package/lib/stacks.js

@@ -1,398 +0,0 @@
-var debug = require('debug')('stacks'),
-    net = require('net'),
-    actorify = require('actorify'),
-    async = require('async');
-
-module.exports = (function stacks() {
-  /**
-   * stacks can either be a server or a client
-   */
-  this.server = null,
-  this.client = null;
-
-  debug('stacks init');
-
-  /**
-   * create a stacks server to listen for client connections
-   *
-   * @api public
-   * @param <Number> port
-   * @param <Function> callback
-   */
-  this.listen = function listen(port, callback) {
-    debug('stacks.listen');
-
-    if (! this.server) {
-      this.server = new StacksServer();
-      this.server.listen(port, callback);
-    } else {
-      console.error(new Error('listen() has already been called on this stacks.'));
-    }
-  };
-
-  /**
-   * make a request to stacks
-   * 
-   * @api public
-   * @param <String> type
-   * @param <Mixed> body
-   * @param <Object> options
-   * @param <Function> callback
-   */
-  this.request = function request(type, body, options, callback) {
-    debug('stacks.request');
-
-    if (this.server) {
-      this.server.request(type, body, options, callback);
-    } else {
-      console.error(new Error('This stacks instance is not a server, and cannot make requests'));
-    }
-  };
-
-  /**
-   * create a stacks client to connect to a stacks server
-   * 
-   * @api public
-   * @param <Mixed> server
-   * @param <Function> callback
-   */
-  this.connect = function connect(server, callback) {
-    debug('stacks.connect');
-
-    if (! this.client) {
-      this.client = new StacksClient();
-      this.client.connect(server, callback);
-    } else {
-      console.error(new Error('connect() has already been called on this stacks'));
-    }
-
-    this.disconnect = this.client.disconnect;
-  };
-
-  return this;
-})();
-
-/**
- * stacks client object prototype
- *
- * @api private
- */
-function StacksClient() {
-  var _actor = null,
-      _connection = null,
-      _queues = {},
-      client = {};
-
-  debug('new instance of StacksClient');
-
-  /**
-   * connect to server
-   * 
-   * @api public
-   * @param <Mixed> server
-   * @param <Function> callback
-   */
-  this.connect = function connect(server, callback) {
-    debug('stacks client connect...');
-
-    _connection = net.connect(server, function() {
-      debug('stacks client connected to stacks server');
-
-      _actor = actorify(_connection);
-
-      /**
-       * handle stacks request of type |type| with worker |worker|
-       * allow |concurrency| concurrent workers
-       *
-       * @api public
-       * @param <String> type
-       * @param <Function> worker
-       * @param <Number> concurrency
-       */
-      client.on = function on(type, worker, concurrency) {
-        debug('create queue for requests of type: ', type);
-
-        _queues[type] = async.queue(worker, concurrency);
-
-        _actor.on(type, function(body, reply) {
-          debug('received stacks request of type %s; with body: ', type, body);
-
-          _queues[type].push(body, reply);
-        });
-      };
-
-      /**
-       * debug messages for socket events
-       */
-      _connection.on('error', function(error) {
-        debug('socket error: ', error);
-      });
-      _connection.on('end', function() {
-        debug('socket end');
-      });
-      _connection.on('close', function() {
-        debug('socket close');
-      });
-      _connection.on('timeout', function() {
-        debug('socket timeout');
-      });
-
-      callback(client);
-    });
-  };
-
-  /**
-   * disconnect stacks client
-   *
-   * @api public
-   */
-  this.disconnect = function disconnect() {
-    _connection.end();
-    delete this.client;
-  };
-};
-
-/**
- * stacks server object prototype
- *
- * @api private
- */
-function StacksServer() {
-  var _backupStacks = [],
-      _clients = {},
-      _requestNumber = 0;
-
-  debug('new instance of StacksServer');
-
-  /**
-   * server connection listener
-   * Note: bind to this in order for this.request to function
-   * 
-   * @api private
-   * @param <Socket> sock
-   */
-  this._connectionListener = function _connectionListener(sock) {
-    var actor = actorify(sock),
-        clientKey = actor.id,
-        _handleSocketClose;
-
-    debug('client with key %s has connected', clientKey);
-    debug('actor', actor);
-
-    /**
-     * handle socket close
-     * Note: bind to this in order for this.request to function
-     */
-    _handleSocketClose = function _handleSocketClose() {
-      var removedClient = _clients[clientKey];
-      debug('client with key %s has disconnected', clientKey);
-
-      delete _clients[clientKey];
-      debug('deleted client with key %s', clientKey);
-
-      /**
-       * request (again) any pending requests on disconnected client
-       */
-      for (requestNumber in removedClient.pendingRequests) {
-        debug('request request number %s again', requestNumber);
-
-        var thisRequest = removedClient.pendingRequests[requestNumber];
-        this.request(thisRequest.type, thisRequest.body, thisRequest.callback);
-      }
-
-    }.bind(this);
-
-    /**
-     * on sock 'error' or 'close', handle socket close
-     */
-    sock.on('error', function(error) {
-      console.error('error: ', error);
-      return _handleSocketClose;
-    });
-    sock.on('close', _handleSocketClose);
-
-    /**
-     * add new client
-     */
-    _clients[clientKey] = {
-      actor: actor,
-      pendingRequests: {}
-    };
-
-    /**
-     * request any requests from backup stacks
-     */
-    for (i in _backupStacks) {
-      var thisRequest = _backupStacks[i];
-
-      debug('request %s request from backup stacks', thisRequest.type);
-
-      this.request(thisRequest.type, thisRequest.body, thisRequest.callback);
-
-      delete _backupStacks[i];
-    }
-  }.bind(this);
-
-  /**
-   * listen for client connections
-   *
-   * @api private
-   * @param <Number> port
-   * @param <Function> callback
-   */
-  this.listen = function listen(port, callback) {
-    var server;
-
-    debug('stacks server listen...');
-
-    if (typeof callback != 'function') {
-      callback = function() {};
-    }
-
-    server = net.createServer(this._connectionListener);
-
-    server.listen(port, function() {
-      debug('stacks server listening on port ', port);
-
-      callback();
-    });
-
-  };
-
-  /**
-   * get the key (actor.id) of the next client to request
-   * uses round-robin distribution
-   * 
-   * @api private
-   */
-  _getNextClientKey = function _getNextClientKey() {
-    var clientKeys = Object.keys(_clients);
-        clientCount = clientKeys.length,
-        nextClientKey = clientKeys[_requestNumber % clientCount];
-
-    debug('get next client key. nextClientKey: ', nextClientKey);
-
-    return nextClientKey;
-  };
-
-  /**
-   * get a client by key (actor.id)
-   *
-   * @api private
-   * @param key
-   */
-  _client = function _client(key) {
-
-    /**
-     * send a request to this client,
-     * add it to this client's pending requests,
-     * when it calls back, remove it from this client's pending requests
-     * call back with error & response body
-     */
-    this.clientRequest = function clientRequest(type, body, options, callback) {
-      debug('client request. _requestNumber: ', options._requestNumber);
-
-      _clients[key].pendingRequests[options._requestNumber] = { 
-        type: type,
-        body: body,
-        callback: callback
-      };
-
-      _clients[key].actor.send(type, body, function(error, response) {
-        debug('client request finished. _requestNumber: ', options._requestNumber);
-
-        delete _clients[key].pendingRequests[options._requestNumber];
-
-        debug('client with key %s\'s pendingRequests: ', key, _clients[key].pendingRequests);
-
-        callback(error, response);
-      });
-    };
-
-    return this;
-  };
-
-  /**
-   * make a request to stacks
-   * 
-   * @api public
-   * @param <String> type
-   * @param <Mixed> body
-   * @param <Object> options
-   * @param <Function> callback
-   */
-  this.request = function request(type, body, options, callback) {
-    debug('stacks.server.request');
-
-    /**
-     * handle options
-     * if typeof options is function, no options were passed
-     */
-    if (typeof options === 'function') {
-      callback = options;
-      options = {};
-    }
-
-    /** 
-     * handle options.maxRetries
-     * if undefined, default to 3
-     */
-    if (typeof options.maxRetries === 'undefined') {
-      options.maxRetries = 3;
-    }
-    
-    /**
-     * handle options._retrySequence
-     * if undefined, default to 0
-     */
-    if (typeof options._retrySequence === 'undefined') {
-      options._retrySequence = 0;
-    }
-
-    /**
-     * set this request's options._requestNumber; increment _requestNumber
-     */
-    options._requestNumber = _requestNumber++;
-
-    /**
-     * if no clients are connected, add request to backup stacks and return
-     */
-    if (Object.keys(_clients).length < 1) {
-      debug('no clients connected, backing up request');
-      
-      _backupStacks.push({
-        type: type,
-        body: body,
-        callback: callback
-      });
-      return;
-    }
-
-    /**
-     * if options._retrySequence++ >= options.maxRetries, 
-     *  request
-     * else
-     *  callback with new error
-     */
-    if (options._retrySequence++ <= options.maxRetries) {
-      _client(_getNextClientKey()).clientRequest(type, body, options, function(error, response) {
-        debug('request finished. _requestNumber: ', options._requestNumber);
-
-        if (error) {
-          debug('request with _requestNumber %s resulted in error: ', options._requestNumber, error);
-
-          this.request(type, body, options, callback);
-        } else {
-          debug('request with _requestNumber %s had response: ', options._requestNumber, response);
-
-          callback(error, response);
-        }
-      });
-    } else {
-      callback(new Error(type +' request failed after max retry attempts'), null);
-    }
-
-  };
-
-
-};

package/test/test.stacks.js

@@ -1,148 +0,0 @@
-var stacks = require('..'),
-    assert = require('assert');
-
-describe('Stacks', function() {
-  describe('#listen()', function() {
-    it('should listen', function(done) {
-      stacks.listen(3000, done);
-    });
-    it('should enable stacks.request', function() {
-      stacks.request('echo', 'echo this', function(error, string) {});
-    });
-    it('should accept stacks clients', function(done) {
-      stacks.connect(3000, function(client) {
-        stacks.disconnect();
-        done();
-      });
-    });
-  });
-  describe('#connect()', function() {
-    it('should connect to stacks server', function(done) {
-      stacks.connect(3000, function(client) {
-        stacks.disconnect();
-        done();
-      });
-    });
-    it('should set stacks.client', function() {
-      stacks.connect(3000, function(client) {
-        assert(typeof stacks.client != 'undefined');
-        stacks.disconnect();
-      });
-    });
-    it('should call back with client (an actor)', function(done) {
-      stacks.connect(3000, function(client) {
-        assert(typeof client != undefined, 'client is undefined');
-        assert(typeof client.on === 'function', 'client has no method `on`')
-        stacks.disconnect();
-
-        done();
-      });
-    });
-  });
-  describe('Client', function() {
-    describe('#disconnect()', function() {
-      it('should disconnect the from stacks server without error', function() {
-        stacks.connect(3000, function(client) {
-          stacks.disconnect();
-        });
-      });
-      it('should delete stacks.client', function() {
-        stacks.connect(3000, function() {
-          stacks.disconnect();
-          assert(typeof stacks.client === 'undefined');
-        });
-      });
-    });
-    describe('#on()', function() {
-      it('should process requests of the specified type', function(done) {
-        stacks.connect(3000, function(client) {
-          var echoString = 'echo this';
-          stacks.request('echo', echoString, function(error, string) {
-            assert(string === echoString, 'echo failed to reply with identical string');
-
-            stacks.disconnect();
-
-            done(error);
-          });
-          client.on('echo', function(string, reply) {
-            var error = null,
-                string = string;
-
-            reply(error, string);
-          });
-        });
-      });
-    });
-  });
-  describe('server', function() {
-    describe('with no connected clients', function() {
-      it('should keep requests on backup stacks until first client connects', function(done) {
-        assert(! stacks.client, 'stacks already had a client – test invalid');
-
-        stacks.request('echo', 'hey, how are you?', function(error, string) {});
-        stacks.connect(3000, function(client) {
-          client.on('echo', function(string, reply) {
-            var error = null;
-            reply(error, string);
-
-            stacks.disconnect();
-
-            done();
-          });
-        });
-      });
-    });
-    it('should re-request requests that were pending on a client that disconnected', function(done) {
-      var waited = false,
-          error = null;
-
-      stacks.request('wait ms', 1000, function(error, waited) {
-        if (! error & waited) {
-          done();
-          stacks.disconnect();
-        }
-      });
-      stacks.connect(3000, function(client) {
-        client.on('wait ms', function(ms, reply) {
-          setTimeout(function() {
-            reply(error, waited);
-          }, ms);
-
-          stacks.disconnect();
-
-          stacks.connect(3000, function(client) {
-            client.on('wait ms', function(ms, reply) {
-              waited = true;
-              
-              reply(error, waited);
-            });
-          });
-          
-        });
-      });
-    });
-    it('should retry failed requests (up to request options.maxRetries times)', function(done) {
-      var attempts = 0;
-
-      stacks.request('echo', 'hey, how are you?', function(error, string) {
-        if (! error) {
-          stacks.disconnect();
-
-          done();
-        }
-      });
-      stacks.connect(3000, function(client) {
-        client.on('echo', function(string, reply) {
-          var error = null;
-
-          if (++attempts <= 2) {
-            error = new Error('echo error');
-          }
-
-          reply(error, string);
-
-        });
-      });
-    });
-  });
-});