Adds specialised outcomeOf Raise DSL to allow for greater interoperability with Results and Eithers

[cwmyers]

This PR adds a specialised Raise DSL for OutcomeOf<A>.

Result<Option<A>>, ErrorOr<Option<A>> and OutcomeOf<A> are isomorphic, meaning they can be converted between each other without loss of information. Given that is the case we can increase the interoperability between them inside the outcomeOf DSL block.

For example:

val outcomeValue : OutcomeOf<Int> = outcomeOf {
      val a = Present(1).bind()
      val b: Int = Result.success(1.some()).bind()
      val c: Int = Either.Right(2).bind()
      val d: Int = Either.Right(4.some()).bindOption()
      val nullValue: Int? = 1
      val e: Int = ensureNotNull(nullValue)
      val f: Int = nullValue.bindNull()
      val g: Int = Result.success(1).bindResult()
      val result = a + b + c + d + e + f + g
      ensure(result > 9)
      result
}

outcomeValue.shouldBePresent().shouldBe(11)

Given Result<Option<A>> is identical to Outcome<A> binding on that type will now just work. For the Result<A> case however the Result<A> needs to be converted to a OutcomeOf<A> before performing a bind, which can be done with bindResult.

Eithers are already native to the DSL and so need to be handled a little differently. Binding over ErrorOr<Option<A>> will require bindOption to first bind over the either and then bind over the Option inside.

Option and nullable values can also be handled with a bind or bindNull respectively. In each case a None or null value will raise an Absent value.