spamcheck/index.js

Uses stopforumspam.com API to compare usernames, emails, and ip addresses to their spam database.

module.exports = {
  /**
   * private : do requests
   * takes the path and callback and does a GET request to stopforumspam.com
   * 
   * @param {String} path - the path to append to the host for the http request
   * @param {Function} callback - callback function excepting (err, result) in return
   */
  _doRequest: function(path, callback) {
    var options = {
      host: 'www.stopforumspam.com',
      path: '/api?f=json' + path
    }
    
    // localize the _isSpammer function to this method
    f = this._isSpammer
    
    // do the http GET request
    require('http').request(options, function(result) {
      f(result, callback);
    }).end(); 
  },
  
  /**
   * private : is spammer
   * Receives the data and checks the existence for 'appears' in any of the follwing objects ['username', 'email', 'ip']
   * 
   * @param {Object} result - the http request result providing events for listening
   * @param {Function} callback - callback function excepting (err, result) in return
   */
  _isSpammer: function(result, callback) {
    var str = '', self = this;
    
    // listen to the data event and build the string
    result.on('data', function(chunk){
      str += chunk;
    });
    
    // listen for errors and fire the callback with the error and no result
    result.on('error', function(err) {
      callback(err, null);
    })
    
    // end of data listener; use to find any existence of appears
    result.on('end', function(){
      var res = JSON.parse(str),
          isSpammer = false;
      
      // check username, email, ip
      if (res.username && isSpammer == false) {
        isSpammer = (res.username.appears == 0) ? false : true;   
      }
      
      if (res.email && isSpammer == false) {
        isSpammer = (res.email.appears == 0) ? false : true;   
      }

      if (res.ip && isSpammer == false) {
        isSpammer = (res.ip.appears == 0) ? false : true;   
      }
      
      // Reply back with true/false if this is a spammer
      callback(null, isSpammer);
   });
  },
  
  /**
   * Check Spammer
   * Takes the object and creates path string the way stopforumspam.com wants it.
   * 
   * @param {Object} user - Object that contains any or all [username, email, ip].  e.g. {username: 'potential_spammer', email: 'spammer@email.com', ip: '0.0.0.0'}
   * @param {Function} callback - callback function excepting (err, result) in return
   */
  checkSpammer: function(user, callback) {
    var path = '';
    
    // loop through the object and prepare a path string for the request.
    for (var i in user) {
      path += '&' + i + '=' + user[i];
    }
    
    // initate the request
    this._doRequest(path, callback);
  }
}