Add option to return header and payload when decoding.

index.js

@@ -4,6 +4,7 @@ var JsonWebTokenError = module.exports.JsonWebTokenError = require('./lib/JsonWe
 var TokenExpiredError = module.exports.TokenExpiredError = require('./lib/TokenExpiredError');
 
 module.exports.decode = function (jwt, options) {
+  options = options || {};
   var decoded = jws.decode(jwt, options);
   var payload = decoded && decoded.payload;
 
@@ -12,11 +13,21 @@ module.exports.decode = function (jwt, options) {
     try {
       var obj = JSON.parse(payload);
       if(typeof obj === 'object') {
-        return obj;
+        payload = obj;
       }
     } catch (e) { }
   }
-
+
+  //return header if `complete` option is enabled.  header includes claims
+  //such as `kid` and `alg` used to select the key within a JWKS needed to
+  //verify the signature
+  if (options.complete === true) {
+    return {
+      header: decoded.header,
+      payload: payload,
+      signature: decoded.signature
+    }
+  }
   return payload;
 };
 

test/jwt.rs.tests.js

@@ -275,5 +275,15 @@ describe('RS256', function() {
       assert.deepEqual(payload, obj);
       done();
     });
+    it('should return the header and payload and signature if complete option is set', function(done) {
+      var obj     = { foo: 'bar' };
+      var token   = jwt.sign(obj, priv, { algorithm: 'RS256' });
+      var decoded = jwt.decode(token, { complete: true });
+      console.log(decoded);
+      assert.deepEqual(decoded.payload, obj);
+      assert.deepEqual(decoded.header, { typ: 'JWT', alg: 'RS256' });
+      assert.ok(typeof decoded.signature == 'string');
+      done();
+    });
   });
 });