Benp/add total event count

@rocha @brianhw @mulby 

I think it makes sense to get started on review. For now, could you ignore (or at most, skim) the test files? 

The prod code is worth a closer look at this point, and I welcome any feedback.
Agreed.  I'm planning to refactor this test file as part of this PR. There's some repetition in here at this point.