Consistent tag definition

Author: dcramer

README.md

@@ -51,7 +51,7 @@ var client = new raven.Client('{{ SENTRY_DSN }}');
 client.captureMessage("Another message")
 ```
 
-**Adding extra info to messages**
+**Adding extra info an event**
 ```javascript
 var raven = require('raven');
 
@@ -60,6 +60,15 @@ var client = new raven.Client('{{ SENTRY_DSN }}');
 client.captureMessage("Another message", {extra: {'key': 'value'}})
 ```
 
+**Adding tags to an event**
+```javascript
+var raven = require('raven');
+
+var client = new raven.Client('{{ SENTRY_DSN }}');
+
+client.captureMessage("Another message", {tags: {'key': 'value'}})
+```
+
 ## Logging an error
 ```javascript
 client.captureError(new Error('Broke!'));

lib/client.js

@@ -55,6 +55,7 @@ _.process = function process(kwargs) {
     if (typeof process.version !== undefined) {
         kwargs['extra']['node'] = process.version;
     }
+    kwargs['tags'] = kwargs['tags'] || {};
     kwargs['logger'] = kwargs['logger'] || this.loggerName;
     kwargs['event_id'] = uuid().replace(/-/g, '');
     kwargs['timestamp'] = new Date().toISOString().split('.')[0];

test/raven.client.js

@@ -438,5 +438,30 @@ describe('raven.Client', function(){
         });
         client.process({message: 'test', extra: {key: 'value'}});
     });
+
+    it('should capture tags', function(done) {
+        var scope = nock('https://app.getsentry.com')
+        .filteringRequestBody(/.*/, '*')
+        .post('/api/store/', '*')
+        .reply(200, function(uri, body) {
+            zlib.inflate(new Buffer(body, 'base64'), function(err, dec) {
+              if (err) return done(err);
+              var msg = JSON.parse(dec.toString());
+              var tags = msg.tags;
+
+              tags.should.have.property('key');
+              tags['key'].should.equal('value');
+
+              done();
+            });
+            return 'OK';
+        });
+
+        client.on('logged', function(){
+            scope.done();
+        });
+        client.process({message: 'test', tags: {key: 'value'}});
+    });
+
 });