improved phpdoc & returns
model class for timer listenings
improved callback code