superagent 0.18.2 → 0.21.0

package/History.md

@@ -1,3 +1,38 @@
+
+0.21.0 / 2014-11-11
+==================
+
+ * Trim text before parsing json (gjohnson)
+ * Update tests to express 4 (gaastonsr)
+ * Prevent double callback when error is thrown (pgn-vole)
+ * Fix missing clearTimeout (nickdima)
+ * Update debug (TooTallNate)
+
+0.20.0 / 2014-10-02
+==================
+
+ * Add toJSON() to request and response instances. (yields)
+ * Prevent HEAD requests from getting parsed. (gjohnson)
+ * Update debug. (TooTallNate)
+
+0.19.1 / 2014-09-24
+==================
+
+ * Fix basic auth issue when password is falsey value. (gjohnson)
+
+0.19.0 / 2014-09-24
+==================
+
+ * Add unset() to browser. (shesek)
+ * Prefer XHR over ActiveX. (omeid)
+ * Catch parse errors. (jacwright)
+ * Update qs dependency. (wercker)
+ * Add use() to node. (Financial-Times)
+ * Add response text to errors. (yields)
+ * Don't send empty cookie headers. (undoZen)
+ * Don't parse empty response bodies. (DveMac)
+ * Use hostname when setting cookie host. (prasunsultania)
+
 0.18.2 / 2014-07-12
 ==================
 

package/component.json

@@ -2,7 +2,7 @@
   "name": "superagent",
   "repo": "visionmedia/superagent",
   "description": "awesome http requests",
-  "version": "0.18.2",
+  "version": "0.20.0",
   "keywords": [
     "http",
     "ajax",

package/components/component-emitter/component.json

@@ -0,0 +1,14 @@
+{
+  "name": "emitter",
+  "repo": "component/emitter",
+  "description": "Event emitter",
+  "keywords": [
+    "emitter",
+    "events"
+  ],
+  "version": "1.1.3",
+  "scripts": [
+    "index.js"
+  ],
+  "license": "MIT"
+}

package/components/component-emitter/index.js

@@ -0,0 +1,164 @@
+
+/**
+ * Expose `Emitter`.
+ */
+
+module.exports = Emitter;
+
+/**
+ * Initialize a new `Emitter`.
+ *
+ * @api public
+ */
+
+function Emitter(obj) {
+  if (obj) return mixin(obj);
+};
+
+/**
+ * Mixin the emitter properties.
+ *
+ * @param {Object} obj
+ * @return {Object}
+ * @api private
+ */
+
+function mixin(obj) {
+  for (var key in Emitter.prototype) {
+    obj[key] = Emitter.prototype[key];
+  }
+  return obj;
+}
+
+/**
+ * Listen on the given `event` with `fn`.
+ *
+ * @param {String} event
+ * @param {Function} fn
+ * @return {Emitter}
+ * @api public
+ */
+
+Emitter.prototype.on =
+Emitter.prototype.addEventListener = function(event, fn){
+  this._callbacks = this._callbacks || {};
+  (this._callbacks[event] = this._callbacks[event] || [])
+    .push(fn);
+  return this;
+};
+
+/**
+ * Adds an `event` listener that will be invoked a single
+ * time then automatically removed.
+ *
+ * @param {String} event
+ * @param {Function} fn
+ * @return {Emitter}
+ * @api public
+ */
+
+Emitter.prototype.once = function(event, fn){
+  var self = this;
+  this._callbacks = this._callbacks || {};
+
+  function on() {
+    self.off(event, on);
+    fn.apply(this, arguments);
+  }
+
+  on.fn = fn;
+  this.on(event, on);
+  return this;
+};
+
+/**
+ * Remove the given callback for `event` or all
+ * registered callbacks.
+ *
+ * @param {String} event
+ * @param {Function} fn
+ * @return {Emitter}
+ * @api public
+ */
+
+Emitter.prototype.off =
+Emitter.prototype.removeListener =
+Emitter.prototype.removeAllListeners =
+Emitter.prototype.removeEventListener = function(event, fn){
+  this._callbacks = this._callbacks || {};
+
+  // all
+  if (0 == arguments.length) {
+    this._callbacks = {};
+    return this;
+  }
+
+  // specific event
+  var callbacks = this._callbacks[event];
+  if (!callbacks) return this;
+
+  // remove all handlers
+  if (1 == arguments.length) {
+    delete this._callbacks[event];
+    return this;
+  }
+
+  // remove specific handler
+  var cb;
+  for (var i = 0; i < callbacks.length; i++) {
+    cb = callbacks[i];
+    if (cb === fn || cb.fn === fn) {
+      callbacks.splice(i, 1);
+      break;
+    }
+  }
+  return this;
+};
+
+/**
+ * Emit `event` with the given args.
+ *
+ * @param {String} event
+ * @param {Mixed} ...
+ * @return {Emitter}
+ */
+
+Emitter.prototype.emit = function(event){
+  this._callbacks = this._callbacks || {};
+  var args = [].slice.call(arguments, 1)
+    , callbacks = this._callbacks[event];
+
+  if (callbacks) {
+    callbacks = callbacks.slice(0);
+    for (var i = 0, len = callbacks.length; i < len; ++i) {
+      callbacks[i].apply(this, args);
+    }
+  }
+
+  return this;
+};
+
+/**
+ * Return array of callbacks for `event`.
+ *
+ * @param {String} event
+ * @return {Array}
+ * @api public
+ */
+
+Emitter.prototype.listeners = function(event){
+  this._callbacks = this._callbacks || {};
+  return this._callbacks[event] || [];
+};
+
+/**
+ * Check if this emitter has `event` handlers.
+ *
+ * @param {String} event
+ * @return {Boolean}
+ * @api public
+ */
+
+Emitter.prototype.hasListeners = function(event){
+  return !! this.listeners(event).length;
+};

package/components/component-reduce/component.json

@@ -0,0 +1,16 @@
+{
+  "name": "reduce",
+  "repo": "component/reduce",
+  "description": "Array reduce component",
+  "version": "1.0.0",
+  "keywords": [
+    "array",
+    "reduce"
+  ],
+  "dependencies": {},
+  "development": {},
+  "license": "Apache, Version 2.0",
+  "scripts": [
+    "index.js"
+  ]
+}

package/components/component-reduce/index.js

@@ -0,0 +1,24 @@
+
+/**
+ * Reduce `arr` with `fn`.
+ *
+ * @param {Array} arr
+ * @param {Function} fn
+ * @param {Mixed} initial
+ *
+ * TODO: combatible error handling?
+ */
+
+module.exports = function(arr, fn, initial){  
+  var idx = 0;
+  var len = arr.length;
+  var curr = arguments.length == 3
+    ? initial
+    : arr[idx++];
+
+  while (idx < len) {
+    curr = fn.call(null, curr, arr[idx], ++idx, arr);
+  }
+  
+  return curr;
+};

package/lib/client.js

@@ -294,7 +294,9 @@ function Response(req, options) {
   options = options || {};
   this.req = req;
   this.xhr = this.req.xhr;
-  this.text = this.xhr.responseText;
+  this.text = this.req.method !='HEAD' 
+     ? this.xhr.responseText 
+     : null;
   this.setStatusProperties(this.xhr.status);
   this.header = this.headers = parseHeader(this.xhr.getAllResponseHeaders());
   // getAllResponseHeaders sometimes falsely returns "" for CORS requests, but
@@ -354,7 +356,7 @@ Response.prototype.setHeaderProperties = function(header){
 
 Response.prototype.parseBody = function(str){
   var parse = request.parse[this.type];
-  return parse
+  return parse && str && str.length
     ? parse(str)
     : null;
 };
@@ -450,9 +452,18 @@ function Request(method, url) {
   this.header = {};
   this._header = {};
   this.on('end', function(){
-    var res = new Response(self);
-    if ('HEAD' == method) res.text = null;
-    self.callback(null, res);
+    var err = null;
+    var res = null;
+
+    try {
+      res = new Response(self); 
+    } catch(e) {
+      err = new Error('Parser is unable to parse the response');
+      err.parse = true;
+      err.original = e;
+    }
+
+    self.callback(err, res);
   });
 }
 
@@ -545,6 +556,26 @@ Request.prototype.set = function(field, val){
   return this;
 };
 
+/**
+ * Remove header `field`.
+ *
+ * Example:
+ *
+ *      req.get('/')
+ *        .unset('User-Agent')
+ *        .end(callback);
+ *
+ * @param {String} field
+ * @return {Request} for chaining
+ * @api public
+ */
+
+Request.prototype.unset = function(field){
+  delete this._header[field.toLowerCase()];
+  delete this.header[field];
+  return this;
+};
+
 /**
  * Get case-insensitive header `field` value.
  *
@@ -779,6 +810,7 @@ Request.prototype.send = function(data){
 
 Request.prototype.callback = function(err, res){
   var fn = this._callback;
+  this.clearTimeout();
   if (2 == fn.length) return fn(err, res);
   if (err) return this.emit('error', err);
   fn(res);

package/lib/node/agent.js

@@ -49,7 +49,7 @@ Agent.prototype.saveCookies = function(res){
 
 Agent.prototype.attachCookies = function(req){
   var url = parse(req.url);
-  var access = CookieAccess(url.host, url.pathname, 'https:' == url.protocol);
+  var access = CookieAccess(url.hostname, url.pathname, 'https:' == url.protocol);
   var cookies = this.jar.getCookies(access).toValueString();
   req.cookies = cookies;
 };

package/lib/node/index.js

@@ -559,6 +559,7 @@ Request.prototype.abort = function(){
   this._aborted = true;
   this.clearTimeout();
   this.req.abort();
+  this.emit('abort');
 };
 
 /**
@@ -622,6 +623,12 @@ Request.prototype.redirect = function(res){
 /**
  * Set Authorization field value with `user` and `pass`.
  *
+ * Examples:
+ *
+ *   .auth('tobi', 'learnboost')
+ *   .auth('tobi:learnboost')
+ *   .auth('tobi')
+ *
  * @param {String} user
  * @param {String} pass
  * @return {Request} for chaining
@@ -629,8 +636,9 @@ Request.prototype.redirect = function(res){
  */
 
 Request.prototype.auth = function(user, pass){
-  if (pass) pass = ':' + pass;
-  var str = new Buffer(user + (pass || '')).toString('base64');
+  if (1 === arguments.length) pass = '';
+  if (!~user.indexOf(':')) user = user + ':';
+  var str = new Buffer(user + pass).toString('base64');
   return this.set('Authorization', 'Basic ' + str);
 };
 
@@ -647,6 +655,15 @@ Request.prototype.ca = function(cert){
   return this;
 };
 
+/**
+ * Allow for extension
+ */
+
+Request.prototype.use = function(fn) {
+  fn(this);
+  return this;
+};
+
 /**
  * Return an http[s] request.
  *
@@ -704,7 +721,7 @@ Request.prototype.request = function(){
   this.query(url.query);
 
   // add cookies
-  req.setHeader('Cookie', this.cookies);
+  if (this.cookies) req.setHeader('Cookie', this.cookies);
 
   // set default UA
   req.setHeader('User-Agent', 'node-superagent/' + pkg.version);
@@ -801,7 +818,18 @@ Request.prototype.end = function(fn){
     var type = type[0];
     var multipart = 'multipart' == type;
     var redirect = isRedirect(res.statusCode);
-    var parser = self._parser
+    var parser = self._parser;
+
+    self.res = res;
+
+    if ('HEAD' == self.method) {
+      var response = new Response(self);
+      self.response = response;
+      response.redirects = self._redirectList;
+      self.emit('response', response);
+      self.emit('end');
+      return;
+    }
 
     if (self.piped) {
       res.on('end', function(){
@@ -829,7 +857,8 @@ Request.prototype.end = function(fn){
 
       form.parse(res, function(err, fields, files){
         if (err) return self.callback(err);
-        var response = new Response(req, res);
+        var response = new Response(self);
+        self.response = response;
         response.body = fields;
         response.files = files;
         response.redirects = self._redirectList;
@@ -843,7 +872,8 @@ Request.prototype.end = function(fn){
     if (!parser && isImage(mime)) {
       exports.parse.image(res, function(err, obj){
         if (err) return self.callback(err);
-        var response = new Response(req, res);
+        var response = new Response(self);
+        self.response = response;
         response.body = obj;
         response.redirects = self._redirectList;
         self.emit('end');
@@ -885,7 +915,8 @@ Request.prototype.end = function(fn){
     if (!buffer) {
       debug('unbuffered %s %s', self.method, self.url);
       self.res = res;
-      var response = new Response(self.req, self.res);
+      var response = new Response(self);
+      self.response = response;
       response.redirects = self._redirectList;
       self.emit('response', response);
       if (multipart) return // allow multipart to handle end event
@@ -901,7 +932,8 @@ Request.prototype.end = function(fn){
     res.on('end', function(){
       debug('end %s %s', self.method, self.url);
       // TODO: unless buffering emit earlier to stream
-      var response = new Response(self.req, self.res);
+      var response = new Response(self);
+      self.response = response;
       response.redirects = self._redirectList;
       self.emit('response', response);
       self.emit('end');
@@ -939,6 +971,21 @@ Request.prototype.end = function(fn){
   return this;
 };
 
+/**
+ * To json.
+ *
+ * @return {Object}
+ * @api public
+ */
+
+Request.prototype.toJSON = function(){
+  return {
+    method: this.method,
+    url: this.url,
+    data: this._data
+  };
+};
+
 /**
  * Expose `Request`.
  */

package/lib/node/parsers/image.js

@@ -1,8 +1,10 @@
-
 module.exports = function(res, fn){
-  var data = '';
-  res.on('data', function(chunk){ data += chunk; });
+  var data = []; // Binary data needs binary storage
+
+  res.on('data', function(chunk){
+      data.push(chunk);
+  });
   res.on('end', function () {
-    fn(null, data);
+      fn(null, Buffer.concat(data));
   });
-};
+};

package/lib/node/parsers/json.js

@@ -5,9 +5,12 @@ module.exports = function(res, fn){
   res.on('data', function(chunk){ res.text += chunk; });
   res.on('end', function(){
     try {
-      fn(null, JSON.parse(res.text));
-    } catch (err) {
-      fn(err);
+      var text = res.text && res.text.replace(/^\s*|\s*$/g, '');
+      var body = text && JSON.parse(text);
+    } catch (e) {
+      var err = e;
+    } finally {
+      fn(err, body);
     }
   });
-};
+};

package/lib/node/response.js

@@ -19,8 +19,7 @@ module.exports = Response;
  *  - set flags (.ok, .error, etc)
  *  - parse header
  *
- * @param {ClientRequest} req
- * @param {IncomingMessage} res
+ * @param {Request} req
  * @param {Object} options
  * @constructor
  * @extends {Stream}
@@ -28,11 +27,12 @@ module.exports = Response;
  * @api private
  */
 
-function Response(req, res, options) {
+function Response(req, options) {
   Stream.call(this);
   options = options || {};
-  this.req = req;
-  this.res = res;
+  var res = this.res = req.res;
+  this.request = req;
+  this.req = req.req;
   this.links = {};
   this.text = res.text;
   this.body = res.body || {};
@@ -105,6 +105,7 @@ Response.prototype.toError = function(){
   var msg = 'cannot ' + method + ' ' + path + ' (' + this.status + ')';
   var err = new Error(msg);
   err.status = this.status;
+  err.text = this.text;
   err.method = method;
   err.path = path;
 
@@ -201,3 +202,19 @@ Response.prototype.setStatusProperties = function(status){
   this.forbidden = 403 == status;
   this.notFound = 404 == status;
 };
+
+/**
+ * To json.
+ *
+ * @return {Object}
+ * @api public
+ */
+
+Response.prototype.toJSON = function(){
+  return {
+    req: this.request.toJSON(),
+    header: this.header,
+    status: this.status,
+    text: this.text
+  };
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "superagent",
-  "version": "0.18.2",
+  "version": "0.21.0",
   "description": "elegant & feature rich browser / node HTTP with a fluent API",
   "scripts": {
     "test": "make test"
@@ -20,24 +20,28 @@
     "url": "git://github.com/visionmedia/superagent.git"
   },
   "dependencies": {
-    "qs": "0.6.6",
+    "qs": "1.2.0",
     "formidable": "1.0.14",
     "mime": "1.2.11",
     "component-emitter": "1.1.2",
     "methods": "1.0.1",
     "cookiejar": "2.0.1",
-    "debug": "~1.0.1",
+    "debug": "2",
     "reduce-component": "1.0.1",
     "extend": "~1.2.1",
     "form-data": "0.1.3",
     "readable-stream": "1.0.27-1"
   },
   "devDependencies": {
-    "zuul": "~1.6.0",
-    "express": "3.5.0",
-    "better-assert": "~0.1.0",
+    "basic-auth-connect": "^1.0.0",
+    "better-assert": "~1.0.1",
+    "body-parser": "^1.9.2",
+    "cookie-parser": "^1.3.3",
+    "express": "^4.9.8",
+    "express-session": "^1.9.1",
+    "mocha": "*",
     "should": "3.1.3",
-    "mocha": "*"
+    "zuul": "~1.6.0"
   },
   "browser": {
     "./lib/node/index.js": "./lib/client.js",
@@ -51,6 +55,6 @@
   },
   "main": "./lib/node/index.js",
   "engines": {
-    "node": "*"
+    "node": ">= 0.8"
   }
 }

package/superagent.js

@@ -690,7 +690,9 @@ function Response(req, options) {
   options = options || {};
   this.req = req;
   this.xhr = this.req.xhr;
-  this.text = this.xhr.responseText;
+  this.text = this.req.method !='HEAD' 
+     ? this.xhr.responseText 
+     : null;
   this.setStatusProperties(this.xhr.status);
   this.header = this.headers = parseHeader(this.xhr.getAllResponseHeaders());
   // getAllResponseHeaders sometimes falsely returns "" for CORS requests, but
@@ -750,7 +752,7 @@ Response.prototype.setHeaderProperties = function(header){
 
 Response.prototype.parseBody = function(str){
   var parse = request.parse[this.type];
-  return parse
+  return parse && str && str.length
     ? parse(str)
     : null;
 };
@@ -846,9 +848,18 @@ function Request(method, url) {
   this.header = {};
   this._header = {};
   this.on('end', function(){
-    var res = new Response(self);
-    if ('HEAD' == method) res.text = null;
-    self.callback(null, res);
+    var err = null;
+    var res = null;
+
+    try {
+      res = new Response(self); 
+    } catch(e) {
+      err = new Error('Parser is unable to parse the response');
+      err.parse = true;
+      err.original = e;
+    }
+
+    self.callback(err, res);
   });
 }
 
@@ -941,6 +952,26 @@ Request.prototype.set = function(field, val){
   return this;
 };
 
+/**
+ * Remove header `field`.
+ *
+ * Example:
+ *
+ *      req.get('/')
+ *        .unset('User-Agent')
+ *        .end(callback);
+ *
+ * @param {String} field
+ * @return {Request} for chaining
+ * @api public
+ */
+
+Request.prototype.unset = function(field){
+  delete this._header[field.toLowerCase()];
+  delete this.header[field];
+  return this;
+};
+
 /**
  * Get case-insensitive header `field` value.
  *
@@ -1175,6 +1206,7 @@ Request.prototype.send = function(data){
 
 Request.prototype.callback = function(err, res){
   var fn = this._callback;
+  this.clearTimeout();
   if (2 == fn.length) return fn(err, res);
   if (err) return this.emit('error', err);
   fn(res);

package/docs/head.html

@@ -1,39 +0,0 @@
-<!DOCTYPE html>
-<html>
-  <head>
-    <title>Superagent</title>
-    <script src="http://ajax.googleapis.com/ajax/libs/jquery/1.4.3/jquery.min.js"></script>
-    <style>
-      body {
-        font: 16px/1.6 "Helvetica Neue", arial, sans-serif;
-        padding: 60px;
-      }
-      pre { font-size: 14px; line-height: 1.3 }
-      code .init { color: #2F6FAD }
-      code .string { color: #5890AD }
-      code .keyword { color: #8A6343 }
-      code .number { color: #2F6FAD }
-    </style>
-    <script>
-      $(function(){
-        $('code').each(function(){
-          $(this).html(highlight($(this).text()));
-        });
-      });
-
-      function highlight(js) {
-        return js
-          .replace(/</g, '&lt;')
-          .replace(/>/g, '&gt;')
-          .replace(/\/\/(.*)/gm, '<span class="comment">//$1</span>')
-          .replace(/('.*')/gm, '<span class="string">$1</span>')
-          .replace(/(\d+\.\d+)/gm, '<span class="number">$1</span>')
-          .replace(/(\d+)/gm, '<span class="number">$1</span>')
-          .replace(/\bnew *(\w+)/gm, '<span class="keyword">new</span> <span class="init">$1</span>')
-          .replace(/\b(function|new|throw|return|var|if|else)\b/gm, '<span class="keyword">$1</span>')
-      }
-    </script>
-  </head>
-  <body>
-    <h1>Superagent</h1>
-    <p>The superagent test suite.</p>

package/docs/index.md

@@ -1,219 +0,0 @@
-# SuperAgent
-
- Super Agent is light-weight progressive ajax API crafted for flexibility, readability, and a low learning curve after being frustrated with many of the existing request APIs.
-
-     request
-       .post('/api/pet')
-       .send({ name: 'Manny', species: 'cat' })
-       .set('X-API-Key', 'foobar')
-       .set('Accept', 'application/json')
-       .end(function(res){
-         if (res.ok) {
-           alert('yay got ' + JSON.stringify(res.body));
-         } else {
-           alert('Oh no! error ' + res.text);
-         }
-       });
-
-## Request basics
-
- A request can be initiated by invoking the appropriate method on the `request` object, then calling `.end()` to send the request. For example a simple GET request:
- 
-     request
-       .get('/search')
-       .end(function(res){
-       
-       });
-
- The __node__ client may also provide absolute urls:
-
-     request
-       .get('http://example.com/search')
-       .end(function(res){
-     
-       });
-
-  __DELETE__, __HEAD__, __POST__, __PUT__ and other __HTTP__ verbs may also be used, simply change the method name:
-  
-    request
-      .head('/favicon.ico')
-      .end(function(res){
-      
-      });
-
-  __DELETE__ is a special-case, as it's a reserved word, so the method is named `.del()`:
-  
-    request
-      .del('/user/1')
-      .end(function(res){
-        
-      });
-
-### Crafting requests
-
-  SuperAgent's flexible API gives you the granularity you need, _when_ you need, yet more concise variations help reduce the amount of code necessary. For example the following GET request:
-  
-    request
-      .get('/search')
-      .end(function(res){
-    
-      });
-
-  Could also be defined as the following, where a callback is given to the HTTP verb method:
-  
-    request
-      .get('/search', function(res){
-    
-      });
-
-   Taking this further the default HTTP verb is __GET__ so the following works as well:
-   
-     request('/search', function(res){
- 
-     });
-
-   This applies to more complicated requests as well, for example the following __GET__ request with a query-string can be written in the chaining manner:
-   
-     request
-       .get('/search')
-       .send({ query: 'tobi the ferret' })
-       .end(function(res){
-         
-       });
-
-   Or one may pass the query-string object to `.get()`:
-   
-     request
-       .get('/search', { query: 'tobi the ferret' })
-       .end(function(res){
-       
-       });
-  
-  Taking this even further the callback may be passed as well:
-  
-     request
-       .get('/search', { query: 'tobi the ferret' }, function(res){
-     
-       });
-
-## Dealing with errors
-
-  On a network error (e.g. connection refused or timeout), SuperAgent emits
-  `error` unless you pass `.end()` a callback with two parameters. Then
-  SuperAgent will invoke it with the error first, followed by a null response.
-
-     request
-       .get('http://wrongurl')
-       .end(function(err, res){
-         console.log('ERROR: ', err)
-       });
-
-  On HTTP errors instead, SuperAgent populates the response with flags
-  indicating the error. See `Response status` below.
-
-## Setting header fields
-
-  Setting header fields is simple, invoke `.set()` with a field name and value:
-  
-     request
-       .get('/search')
-       .set('API-Key', 'foobar')
-       .set('Accept', 'application/json')
-       .end(callback);
-
-## GET requests
-
- The `.send()` method accepts objects, which when used with the __GET__ method will form a query-string. The following will produce the path `/search?query=Manny&range=1..5&order=desc`.
- 
-     request
-       .get('/search')
-       .send({ query: 'Manny' })
-       .send({ range: '1..5' })
-       .send({ order: 'desc' })
-       .end(function(res){
-
-       });
-
-  The `.send()` method accepts strings as well:
-  
-      request
-        .get('/querystring')
-        .send('search=Manny&range=1..5')
-        .end(function(res){
-
-        });
-
-### POST / PUT requests
-
-  A typical JSON __POST__ request might look a little like the following, where we set the Content-Type header field appropriately, and "write" some data, in this case just a JSON string.
-
-      request.post('/user')
-        .set('Content-Type', 'application/json')
-        .send('{"name":"tj","pet":"tobi"})
-        .end(callback)
-
-  Since JSON is undoubtably the most common, it's the _default_! The following example is equivalent to the previous.
-
-      request.post('/user')
-        .send({ name: 'tj', pet: 'tobi' })
-        .end(callback)
-
-  Or using multiple `.send()` calls:
-  
-      request.post('/user')
-        .send({ name: 'tj' })
-        .send({ pet: 'tobi' })
-        .end(callback)
-
-  SuperAgent formats are extensible, however by default "json" and "form" are supported. To send the data as `application/x-www-form-urlencoded` simply invoke `.type()` with "form-data", where the default is "json". This request will POST the body "name=tj&pet=tobi".
-
-      request.post('/user')
-        .type('form')
-        .send({ name: 'tj' })
-        .send({ pet: 'tobi' })
-        .end(callback)
-
-## Response properties
-
-  Many helpful flags and properties are set on the `Response` object, ranging from the response text, parsed response body, header fields, status flags and more.
-  
-### Response text
-
-  The `res.text` property contains the unparsed response body string.
-
-### Response body
-
-  Much like SuperAgent can auto-serialize request data, it can also automatically parse it. When a parser is defined for the Content-Type, it is parsed, which by default includes "application/json" and "application/x-www-form-urlencoded". The parsed object is then available via `res.body`.
-
-### Response header fields
-
-  The `res.header` contains an object of parsed header fields, lowercasing field names much like node does. For example `res.header['content-length']`.
-
-### Response Content-Type
-
-  The Content-Type response header is special-cased, providing `res.contentType`, which is void of the charset (if any). For example the Content-Type of "text/html; charset=utf8" will provide "text/html" as `res.contentType`, and the `res.charset` property would then contain "utf8".
-
-### Response status
-
-  The response status flags help determine if the request was a success, among other useful information, making SuperAgent ideal for interacting with RESTful web services. These flags are currently defined as:
-  
-     var type = status / 100 | 0;
-
-     // status / class
-     res.status = status;
-     res.statusType = type;
-
-     // basics
-     res.info = 1 == type;
-     res.ok = 2 == type;
-     res.clientError = 4 == type;
-     res.serverError = 5 == type;
-     res.error = 4 == type || 5 == type;
-
-     // sugar
-     res.accepted = 202 == status;
-     res.noContent = 204 == status || 1223 == status;
-     res.badRequest = 400 == status;
-     res.unauthorized = 401 == status;
-     res.notAcceptable = 406 == status;
-     res.notFound = 404 == status;

package/docs/tail.html

@@ -1,2 +0,0 @@
-  </body>
-</html>