added helper to README and cleaned up the code

README.md

@@ -108,6 +108,22 @@ An interface to the deployed EventBridge, allowing events to be injected and int
     eventBridge.destroy() - remove infastructure used to track events
 ```
 
+### Step Functions
+
+An interface to a deployed Step Function, with a function to execute a Step Function until its completion.
+
+#### Static
+
+```
+  StepFunctions.build() // create a Step Functions Client for executing existing state machines
+```
+
+#### Instance
+
+```
+  stepFunctions.runExecution(stateMachineName, input) // executes state machine until completion
+```
+
 ## Running with `jest`
 
 ### Arguments

src/helpers/stepFunctions.ts

@@ -19,10 +19,6 @@ export default class StepFunctions {
   }
 
   async runExecution(stateMachineName: string, input: any): Promise<any> {
-    // this.stepFunctions = new AWSStepFunctions();
-    // this.allStateMachines = await this.stepFunctions
-    //   .listStateMachines()
-    //   .promise();
     if (this.allStateMachines === undefined) {
       throw new Error(
         "The list of state machines is undefined. You might have forgotten to run build()."
@@ -50,6 +46,7 @@ export default class StepFunctions {
     const executionList = await this.stepFunctions
       .listExecutions(listExecParams)
       .promise();
+    // Poll until the given execution is no longer running
     while (
       executionList.executions.filter(
         (exec: any) =>