feat(clients): adding throwable waiters WaitUntil[operationState]

[alexforsyth]

Issue

#1917
Issue number, if available, prefixed with "#"

Description

1. Adds another method: WaitUntilBlahBlah that throws when a waiter enters a non-success state
2. Adds a deprecation flag to WaitForBlahBlah since it doesn't throw.
3. Adds an optional reason type to the waiterResultObject. This gives clues as to why a waiter entered a particular state.

What does this implement/fix? Explain your changes.

Testing

How was this change tested?

Additional context

Add any other context about the PR here.

---

By submitting this pull request, I confirm that you can use, modify, copy, and redistribute this contribution, under the terms of your choice.

[codecov-commenter]

Codecov Report

❗ No coverage uploaded for pull request base (main@48ab750). Click here to learn what that means.
The diff coverage is n/a.

@@           Coverage Diff           @@
##             main    #2302   +/-   ##
=======================================
  Coverage        ?   60.02%           
=======================================
  Files           ?      472           
  Lines           ?    24847           
  Branches        ?     5885           
=======================================
  Hits            ?    14915           
  Misses          ?     9932           
  Partials        ?        0           

---

Continue to review full report at Codecov.

Legend - Click here to learn more
Δ = absolute <relative> (impact), ø = not affected, ? = missing data
Powered by Codecov. Last update 48ab750...8cb0932. Read the comment docs.

[AllanZhengYP]

This PR needs rebase @alexforsyth

[AllanZhengYP]

All the SDK related interfaces should be exported from @aws-sdk/types package, including waiters interface. It will help users as well as documentation. You need to export them from @aws-sdk/types and reexport them in @aws-sdk/util-waiter to avoid breaking change.

[trivikr]

Remove documentation, as we're now recommending customers to use abortSignal.

Suggested change

	/**
	* @deprecated Use abortSignal
	* Abort controller. Used for ending the waiter early.
	*/
	/**
	* @deprecated Use `abortSignal` instead.
	*/

[github-actions]

This thread has been automatically locked since there has not been any recent activity after it was closed. Please open a new issue for related bugs and link to relevant comments in this thread.