Update IStateMachine to include grantStartExecution

[BenChaimberg]

Update IStateMachine to include grantStartExecution.

Use Case

This will allow state machine constructs created from an imported ARN to grant permissions just like a state machine construct created through the constructor can. This is obviously much nicer than creating the PolicyDocument with the appropriate permissions manually.

Proposed Solution

Add the grantStartExecution method signature to the IStateMachine interface.

export interface IStateMachine extends IResource {
  // ...

  /**
   * Grant the given identity permissions to start an execution of this state
   * machine.
   *
   * @param identity The principal
   */
  grantStartExecution(identity: iam.IGrantable): iam.Grant;
}

Other

• 👋 I may be able to implement this feature request
• ⚠️ This feature might incur a breaking change

---

This is a 🚀 Feature Request