@ehrelein/nothrow/README.md

Type-safe error handling

[![nothrow banner](https://imgur.com/DcE3MIk.png)](https://github.com/Ehrelein/nothrow?tab=readme-ov-file)
[View on GitHub](https://github.com/Ehrelein/nothrow?tab=readme-ov-file)

## Usage

```typescript
let file = safeCall(readFileSync, "test.txt") // <-- calls any function
let wrapperReadFile = wrap(readFile) // <-- wraps any function

log(file.value) // <-- error, no value field in file yet
if (file.ok) log(file.value) // <-- here it exists
file.ok ? log(file.value) : log(file.error)
file.invert ?? log(file.value)

log(file.flat) // <-- has either value or error
file.log() // <-- logs the value of flat
file.log(0, 10) // <-- converts to string and clices
file.slice(0, 10) // <-- same but does not log

file.map((v) => v.toUpperCase()) // <-- maps the value to uppercase

function canFail() {
    // <-- returns Result<string>
    const shouldFail = Math.random() > 0.5
    if (shouldFail) return Err(new Error("Failed")) // <-- has call stack
    return Ok("Success")
}
canFail().ok

const wrapped = wrap(readFile) // <-- function wrapper
const res = await wrapped("test.txt")
res.flat // <-- has the value or error
```