[Workflow] Added an transition completed event

Author: izzyp

CHANGELOG.md

@@ -5,6 +5,7 @@ CHANGELOG
 -----
 
  * Added support for `Event::getWorkflowName()` for "announce" events.
+ * Added `workflow.completed` events which are fired after a transition is completed.
 
 3.3.0
 -----

Tests/WorkflowTest.php

@@ -287,6 +287,9 @@ public function testApplyWithEventDispatcher()
             'workflow.workflow_name.entered',
             'workflow.workflow_name.entered.b',
             'workflow.workflow_name.entered.c',
+            'workflow.completed',
+            'workflow.workflow_name.completed',
+            'workflow.workflow_name.completed.t1',
             // Following events are fired because of announce() method
             'workflow.announce',
             'workflow.workflow_name.announce',

Workflow.php

@@ -151,6 +151,8 @@ public function apply($subject, $transitionName)
 
             $this->entered($subject, $transition, $marking);
 
+            $this->completed($subject, $transition, $marking);
+
             $this->announce($subject, $transition, $marking);
         }
 
@@ -309,6 +311,19 @@ private function entered($subject, Transition $transition, Marking $marking)
         }
     }
 
+    private function completed($subject, Transition $transition, Marking $marking)
+    {
+        if (null === $this->dispatcher) {
+            return;
+        }
+
+        $event = new Event($subject, $marking, $transition, $this->name);
+
+        $this->dispatcher->dispatch('workflow.completed', $event);
+        $this->dispatcher->dispatch(sprintf('workflow.%s.completed', $this->name), $event);
+        $this->dispatcher->dispatch(sprintf('workflow.%s.completed.%s', $this->name, $transition->getName()), $event);
+    }
+
     private function announce($subject, Transition $initialTransition, Marking $marking)
     {
         if (null === $this->dispatcher) {