Events validation. Closes #27

lib/index.js

@@ -38,7 +38,7 @@ internals.schema.listener = internals.schema.event.keys({
 });
 
 
-exports = module.exports = internals.Podium = function (events) {
+exports = module.exports = internals.Podium = function (events, options) {
 
     // Use descriptive names to avoid conflict when inherited
 
@@ -50,7 +50,7 @@ exports = module.exports = internals.Podium = function (events) {
     this.onPodiumError = null;
 
     if (events) {
-        this.registerEvent(events);
+        this.registerEvent(events, options);
     }
 };
 
@@ -69,7 +69,23 @@ internals.Podium.decorate = function (target, source) {
 };
 
 
-internals.Podium.prototype.registerEvent = function (events) {
+internals.Podium.validate = function (events) {
+
+    const normalized = [];
+    [].concat(events).forEach((event) => {
+
+        if (typeof event === 'string') {
+            event = { name: event };
+        }
+
+        normalized.push(Joi.attempt(event, internals.schema.event, 'Invalid event options'));
+    });
+
+    return normalized;
+};
+
+
+internals.Podium.prototype.registerEvent = function (events, options = {}) {
 
     events = Hoek.flatten([].concat(events));
     events.forEach((event) => {
@@ -86,7 +102,9 @@ internals.Podium.prototype.registerEvent = function (events) {
             event = { name: event };
         }
 
-        event = Joi.attempt(event, internals.schema.event, 'Invalid event options');
+        if (options.validate !== false) {                                                       // Defaults to true
+            event = Joi.attempt(event, internals.schema.event, 'Invalid event options');
+        }
 
         const name = event.name;
         if (this._eventListeners[name]) {

package.json

@@ -1,7 +1,7 @@
 {
   "name": "podium",
   "description": "Node compatible event emitter with extra features",
-  "version": "2.0.3",
+  "version": "2.1.0",
   "repository": "git://github.com/hapijs/podium",
   "main": "lib/index.js",
   "keywords": [

test/index.js

@@ -700,6 +700,22 @@ describe('Podium', () => {
         });
     });
 
+    describe('validate()', () => {
+
+        it('normalizes events', async () => {
+
+            expect(Podium.validate('a')).to.equal([{ name: 'a' }]);
+        });
+
+        it('errors on invalid event property', async () => {
+
+            expect(() => {
+
+                Podium.validate({ name: 'a', unknown: 'x' });
+            }).to.throw(/Invalid event options/);
+        });
+    });
+
     describe('registerEvent()', () => {
 
         it('combines multiple sources', (done) => {
@@ -742,6 +758,24 @@ describe('Podium', () => {
                 source.registerEvent('a');
             }).to.throw('Event a exists');
         });
+
+        it('errors on invalid event property', async () => {
+
+            const source = new Podium();
+            expect(() => {
+
+                source.registerEvent({ name: 'a', unknown: 'x' });
+            }).to.throw(/Invalid event options/);
+        });
+
+        it('ignores invalid event property', async () => {
+
+            const source = new Podium();
+            expect(() => {
+
+                source.registerEvent({ name: 'a', unknown: 'x' }, { validate: false });
+            }).to.not.throw();
+        });
     });
 
     describe('registerPodium()', () => {