@e280/stz 0.2.30 → 0.2.31

package/README.md

@@ -338,22 +338,24 @@ rust-inspired pattern for explicit error handling instead of the usual js yolo v
   ```
 
 #### helpers
-- `grab(result)` — get the value, or `undefined`
+- `getOk(result)` — get the value, or `undefined`
   ```ts
-  grab(ok(123))
+  getOk(ok(123))
     // 123
 
-  grab(err("nope"))
+  getOk(err("nope"))
     // undefined
   ```
-- `need(result)` — get the value, or throw
+  - there is also `getErr(result)`
+- `needOk(result)` — get the value, or throw
   ```ts
-  need(ok(123))
+  needOk(ok(123))
     // 123
 
-  need(err("containment lost"))
+  needOk(err("containment lost"))
     // throws Error("containment lost")
   ```
+  - there is also `needErr(result)`
 
 
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@e280/stz",
-	"version": "0.2.30",
+	"version": "0.2.31",
 	"description": "everyday ts fns for everything",
 	"license": "MIT",
 	"author": "Chase Moskal <chasemoskal@gmail.com>",
@@ -23,7 +23,7 @@
 	},
 	"devDependencies": {
 		"@e280/science": "^0.1.10",
-		"@types/node": "^25.5.2",
+		"@types/node": "^25.6.0",
 		"typescript": "^6.0.2"
 	},
 	"keywords": [

package/s/dig/test.ts

@@ -1,12 +1,12 @@
 
 import {suite, expect, assert} from "@e280/science"
 import {dig} from "./dig.js"
-import {need} from "../ok/index.js"
+import {needOk} from "../ok/index.js"
 
 const check = (t: any, path: (string | number)[]) => ({
 	ok: (value: any) => async() => {
 		const result = dig(t, path)
-		expect(need(result)).is(value)
+		expect(needOk(result)).is(value)
 	},
 	err: (e: any) => async() => {
 		const result = dig(t, path)

package/s/error-string.ts

@@ -0,0 +1,7 @@
+
+export function errorString(error: unknown, fallback = "error"): string {
+	if (typeof error === "string") return error
+	else if (error instanceof Error) return error.message
+	else return fallback
+}
+

package/s/index.ts

@@ -42,6 +42,7 @@ export * from "./defer.js"
 export * from "./dispenser.js"
 export * from "./disposer.js"
 export * from "./drill.js"
+export * from "./error-string.js"
 export * from "./escape-regex.js"
 export * from "./ev.js"
 export * from "./hat.js"

package/s/ok/fns/attempt.ts

@@ -0,0 +1,29 @@
+
+import {ok} from "./ok.js"
+import {err} from "./err.js"
+import {Result} from "../types/result.js"
+
+export function attempt<Value, E = unknown>(fn: () => Value): Result<Value, E> {
+	try {
+		return ok(fn())
+	}
+	catch (error) {
+		return err(error as E)
+	}
+}
+
+export async function attemptAsync<Value, E = unknown>(
+		input: Promise<Value> | (() => Promise<Value>),
+	): Promise<Result<Value, E>> {
+
+	try {
+		const promise = (typeof input === "function")
+			? input()
+			: input
+		return ok(await promise)
+	}
+	catch (error) {
+		return err(error as E)
+	}
+}
+

package/s/ok/fns/err.ts

@@ -2,7 +2,7 @@
 import type {Err} from "../types/err.js"
 
 /** failure */
-export function err<E = string>(error: E): Err<E> {
+export function err<E>(error: E): Err<E> {
 	return {ok: false, error}
 }
 

package/s/ok/fns/get.ts

@@ -0,0 +1,20 @@
+
+import type {Result} from "../types/result.js"
+
+/** get value or undefined */
+export function getOk<Value>(result: Result<Value, unknown>): Value | undefined {
+	return result.ok
+		? result.value
+		: undefined
+}
+
+/** get error or undefined */
+export function getErr<E = unknown>(result: Result<unknown, E>): E | undefined {
+	return result.ok
+		? undefined
+		: result.error
+}
+
+/** @deprecated renamed to `getOk` */
+export const grab = getOk
+

package/s/ok/fns/need.ts

@@ -1,8 +1,8 @@
 
 import type {Result} from "../types/result.js"
 
-/** get value or throw error */
-export function need<Value, E>(result: Result<Value, E>): Value {
+/** return ok value, otherwise throw error */
+export function needOk<Value, E>(result: Result<Value, E>): Value {
 	if (result.ok)
 		return result.value
 
@@ -18,3 +18,12 @@ export function need<Value, E>(result: Result<Value, E>): Value {
 		throw new Error("unknown")
 }
 
+/** return error, otherwise throw error */
+export function needErr<E>(result: Result<unknown, E>): E {
+	if (result.ok) throw new Error("didn't get needed error")
+	return result.error
+}
+
+/** @deprecated renamed to `needOk` */
+export const need = needOk
+

package/s/ok/index.ts

@@ -1,7 +1,8 @@
 
+export * from "./fns/attempt.js"
 export * from "./fns/ok.js"
 export * from "./fns/err.js"
-export * from "./fns/grab.js"
+export * from "./fns/get.js"
 export * from "./fns/need.js"
 
 export * from "./types/ok.js"

package/s/ok/test.ts

@@ -1,7 +1,7 @@
 
 import {expect, suite, test} from "@e280/science"
 import {thrown} from "../thrown.js"
-import {ok, err, grab, need} from "./index.js"
+import {ok, err, getOk, needOk, attempt, needErr, getErr, attemptAsync} from "./index.js"
 
 export default suite({
 	"ok": test(async() => {
@@ -16,31 +16,53 @@ export default suite({
 		expect("value" in err("nope")).is(false)
 	}),
 
-	"grab": test(async() => {
-		expect(grab(ok(123))).is(123)
-		expect(grab(err("nope"))).is(undefined)
+	"getOk": test(async() => {
+		expect(getOk(ok(123))).is(123)
+		expect(getOk(err("nope"))).is(undefined)
 	}),
 
-	"need": test(async() => {
-		expect(need(ok(123))).is(123)
-		expect(() => need(err("nope"))).throws()
+	"getErr": test(async() => {
+		expect(getErr(err("nope"))).is("nope")
+		expect(getErr(ok(123))).is(undefined)
 	}),
 
-	"need error handling": {
+	"needOk": test(async() => {
+		expect(needOk(ok(123))).is(123)
+		expect(() => needOk(err("nope"))).throws()
+	}),
+
+	"needErr": test(async() => {
+		expect(needErr(err("nope"))).is("nope")
+		expect(() => needErr(ok(123))).throws()
+	}),
+
+	"attempt": test(async() => {
+		expect(needOk(attempt(() => 123))).is(123)
+		expect(attempt(() => {throw new Error("rofl")}).ok).is(false)
+		expect(needErr<Error>(attempt(() => {throw new Error("rofl")})).message).is("rofl")
+	}),
+
+	"attemptAsync": test(async() => {
+		expect(needOk(await attemptAsync(async() => 123))).is(123)
+		expect((await attemptAsync(async() => {throw new Error("rofl")})).ok).is(false)
+		expect(needErr<Error>(await attemptAsync(async() => {throw new Error("rofl")})).message).is("rofl")
+	}),
+
+	"needOk error handling": {
 		"rethrows errors": test(async() => {
 			const error = new TypeError()
-			expect(() => need(err(error))).throws(TypeError)
-			expect(thrown(() => need(err(error)))).is(error)
+			expect(() => needOk(err(error))).throws(TypeError)
+			expect(thrown(() => needOk(err(error)))).is(error)
 		}),
 
 		"upgrades strings to errors": test(async() => {
-			expect(() => need(err("nope"))).throws(Error)
-			expect(thrown(() => need(err("nope"))).message).is("nope")
+			expect(() => needOk(err("nope"))).throws(Error)
+			expect(thrown(() => needOk(err("nope"))).message).is("nope")
 		}),
 
 		"everything else is unknown": test(async() => {
-			expect(() => need(err({code: 234}))).throws(Error)
-			expect(thrown(() => need(err({code: 234}))).message).is("unknown")
+			expect(() => needOk(err({code: 234}))).throws(Error)
+			expect(thrown(() => needOk(err({code: 234}))).message).is("unknown")
 		}),
 	},
 })

package/x/dig/test.js

@@ -1,10 +1,10 @@
 import { suite, expect, assert } from "@e280/science";
 import { dig } from "./dig.js";
-import { need } from "../ok/index.js";
+import { needOk } from "../ok/index.js";
 const check = (t, path) => ({
     ok: (value) => async () => {
         const result = dig(t, path);
-        expect(need(result)).is(value);
+        expect(needOk(result)).is(value);
     },
     err: (e) => async () => {
         const result = dig(t, path);

package/x/dig/test.js.map

@@ -1 +1 @@
-{"version":3,"file":"test.js","sourceRoot":"","sources":["../../s/dig/test.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAC,MAAM,eAAe,CAAA;AACnD,OAAO,EAAC,GAAG,EAAC,MAAM,UAAU,CAAA;AAC5B,OAAO,EAAC,IAAI,EAAC,MAAM,gBAAgB,CAAA;AAEnC,MAAM,KAAK,GAAG,CAAC,CAAM,EAAE,IAAyB,EAAE,EAAE,CAAC,CAAC;IACrD,EAAE,EAAE,CAAC,KAAU,EAAE,EAAE,CAAC,KAAK,IAAG,EAAE;QAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;QAC3B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAA;IAC/B,CAAC;IACD,GAAG,EAAE,CAAC,CAAM,EAAE,EAAE,CAAC,KAAK,IAAG,EAAE;QAC1B,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;QAC3B,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QAClB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAC3B,CAAC;CACD,CAAC,CAAA;AAEF,eAAe,KAAK,CAAC;IACpB,WAAW,EAAE,KAAK,CAAC,EAAC,CAAC,EAAE,CAAC,EAAC,EAAE,CAAC,GAAG,CAAC,CAAC;SAC/B,EAAE,CAAC,CAAC,CAAC;IAEP,eAAe,EAAE,KAAK,CAAC,EAAC,CAAC,EAAE,SAAS,EAAC,EAAE,CAAC,GAAG,CAAC,CAAC;SAC3C,EAAE,CAAC,SAAS,CAAC;IAEf,UAAU,EAAE,KAAK,CAAC,EAAC,CAAC,EAAE,IAAI,EAAC,EAAE,CAAC,GAAG,CAAC,CAAC;SACjC,EAAE,CAAC,IAAI,CAAC;IAEV,kBAAkB,EAAE,KAAK,CAAC,EAAC,CAAC,EAAE,EAAC,CAAC,EAAE,CAAC,EAAC,EAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;SAChD,EAAE,CAAC,CAAC,CAAC;IAEP,iBAAiB,EAAE,KAAK,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;SACvC,EAAE,CAAC,GAAG,CAAC;IAET,sBAAsB,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;SACxC,GAAG,CAAC,iBAAiB,CAAC;IAExB,2BAA2B,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC;SAClD,GAAG,CAAC,iBAAiB,CAAC;IAExB,uBAAuB,EAAE,KAAK,CAAC,EAAC,CAAC,EAAE,CAAC,EAAC,EAAE,CAAC,GAAG,CAAC,CAAC;SAC3C,GAAG,CAAC,WAAW,CAAC;IAElB,uBAAuB,EAAE,KAAK,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;SAC7C,GAAG,CAAC,WAAW,CAAC;IAElB,wBAAwB,EAAE,KAAK,CAAC,EAAC,CAAC,EAAE,CAAC,EAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;SACjD,GAAG,CAAC,iBAAiB,CAAC;IAExB,kBAAkB,EAAE,KAAK,CAAC,EAAC,CAAC,EAAE,EAAE,EAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;SAC5C,GAAG,CAAC,WAAW,CAAC;CAClB,CAAC,CAAA"}
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../../s/dig/test.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAC,MAAM,eAAe,CAAA;AACnD,OAAO,EAAC,GAAG,EAAC,MAAM,UAAU,CAAA;AAC5B,OAAO,EAAC,MAAM,EAAC,MAAM,gBAAgB,CAAA;AAErC,MAAM,KAAK,GAAG,CAAC,CAAM,EAAE,IAAyB,EAAE,EAAE,CAAC,CAAC;IACrD,EAAE,EAAE,CAAC,KAAU,EAAE,EAAE,CAAC,KAAK,IAAG,EAAE;QAC7B,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;QAC3B,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAA;IACjC,CAAC;IACD,GAAG,EAAE,CAAC,CAAM,EAAE,EAAE,CAAC,KAAK,IAAG,EAAE;QAC1B,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;QAC3B,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAA;QAClB,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;IAC3B,CAAC;CACD,CAAC,CAAA;AAEF,eAAe,KAAK,CAAC;IACpB,WAAW,EAAE,KAAK,CAAC,EAAC,CAAC,EAAE,CAAC,EAAC,EAAE,CAAC,GAAG,CAAC,CAAC;SAC/B,EAAE,CAAC,CAAC,CAAC;IAEP,eAAe,EAAE,KAAK,CAAC,EAAC,CAAC,EAAE,SAAS,EAAC,EAAE,CAAC,GAAG,CAAC,CAAC;SAC3C,EAAE,CAAC,SAAS,CAAC;IAEf,UAAU,EAAE,KAAK,CAAC,EAAC,CAAC,EAAE,IAAI,EAAC,EAAE,CAAC,GAAG,CAAC,CAAC;SACjC,EAAE,CAAC,IAAI,CAAC;IAEV,kBAAkB,EAAE,KAAK,CAAC,EAAC,CAAC,EAAE,EAAC,CAAC,EAAE,CAAC,EAAC,EAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;SAChD,EAAE,CAAC,CAAC,CAAC;IAEP,iBAAiB,EAAE,KAAK,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;SACvC,EAAE,CAAC,GAAG,CAAC;IAET,sBAAsB,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;SACxC,GAAG,CAAC,iBAAiB,CAAC;IAExB,2BAA2B,EAAE,KAAK,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC;SAClD,GAAG,CAAC,iBAAiB,CAAC;IAExB,uBAAuB,EAAE,KAAK,CAAC,EAAC,CAAC,EAAE,CAAC,EAAC,EAAE,CAAC,GAAG,CAAC,CAAC;SAC3C,GAAG,CAAC,WAAW,CAAC;IAElB,uBAAuB,EAAE,KAAK,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;SAC7C,GAAG,CAAC,WAAW,CAAC;IAElB,wBAAwB,EAAE,KAAK,CAAC,EAAC,CAAC,EAAE,CAAC,EAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;SACjD,GAAG,CAAC,iBAAiB,CAAC;IAExB,kBAAkB,EAAE,KAAK,CAAC,EAAC,CAAC,EAAE,EAAE,EAAC,EAAE,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;SAC5C,GAAG,CAAC,WAAW,CAAC;CAClB,CAAC,CAAA"}

package/x/error-string.d.ts

@@ -0,0 +1 @@
+export declare function errorString(error: unknown, fallback?: string): string;

package/x/error-string.js

@@ -0,0 +1,9 @@
+export function errorString(error, fallback = "error") {
+    if (typeof error === "string")
+        return error;
+    else if (error instanceof Error)
+        return error.message;
+    else
+        return fallback;
+}
+//# sourceMappingURL=error-string.js.map

package/x/error-string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-string.js","sourceRoot":"","sources":["../s/error-string.ts"],"names":[],"mappings":"AACA,MAAM,UAAU,WAAW,CAAC,KAAc,EAAE,QAAQ,GAAG,OAAO;IAC7D,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAA;SACtC,IAAI,KAAK,YAAY,KAAK;QAAE,OAAO,KAAK,CAAC,OAAO,CAAA;;QAChD,OAAO,QAAQ,CAAA;AACrB,CAAC"}

package/x/index.d.ts

@@ -35,6 +35,7 @@ export * from "./defer.js";
 export * from "./dispenser.js";
 export * from "./disposer.js";
 export * from "./drill.js";
+export * from "./error-string.js";
 export * from "./escape-regex.js";
 export * from "./ev.js";
 export * from "./hat.js";

package/x/index.js

@@ -35,6 +35,7 @@ export * from "./defer.js";
 export * from "./dispenser.js";
 export * from "./disposer.js";
 export * from "./drill.js";
+export * from "./error-string.js";
 export * from "./escape-regex.js";
 export * from "./ev.js";
 export * from "./hat.js";

package/x/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../s/index.ts"],"names":[],"mappings":"AACA,cAAc,6BAA6B,CAAA;AAC3C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,yBAAyB,CAAA;AACvC,cAAc,yBAAyB,CAAA;AACvC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,sBAAsB,CAAA;AACpC,cAAc,yBAAyB,CAAA;AACvC,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAE7B,cAAc,wBAAwB,CAAA;AACtC,cAAc,2BAA2B,CAAA;AACzC,cAAc,qBAAqB,CAAA;AAEnC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAE5B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAE/B,cAAc,kBAAkB,CAAA;AAEhC,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAEhC,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../s/index.ts"],"names":[],"mappings":"AACA,cAAc,6BAA6B,CAAA;AAC3C,cAAc,+BAA+B,CAAA;AAC7C,cAAc,yBAAyB,CAAA;AACvC,cAAc,yBAAyB,CAAA;AACvC,cAAc,4BAA4B,CAAA;AAC1C,cAAc,sBAAsB,CAAA;AACpC,cAAc,yBAAyB,CAAA;AACvC,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,eAAe,CAAA;AAE7B,cAAc,wBAAwB,CAAA;AACtC,cAAc,2BAA2B,CAAA;AACzC,cAAc,qBAAqB,CAAA;AAEnC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,cAAc,CAAA;AAE5B,cAAc,YAAY,CAAA;AAC1B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAE/B,cAAc,kBAAkB,CAAA;AAEhC,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,kBAAkB,CAAA;AAEhC,cAAc,UAAU,CAAA;AACxB,cAAc,aAAa,CAAA;AAC3B,cAAc,eAAe,CAAA;AAC7B,cAAc,cAAc,CAAA;AAC5B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,eAAe,CAAA;AAC7B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,eAAe,CAAA;AAC7B,cAAc,YAAY,CAAA;AAC1B,cAAc,mBAAmB,CAAA;AACjC,cAAc,mBAAmB,CAAA;AACjC,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,iBAAiB,CAAA;AAC/B,cAAc,SAAS,CAAA;AACvB,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AACzB,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,aAAa,CAAA;AAC3B,cAAc,WAAW,CAAA;AACzB,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA;AAC1B,cAAc,YAAY,CAAA"}

package/x/ok/fns/attempt.d.ts

@@ -0,0 +1,3 @@
+import { Result } from "../types/result.js";
+export declare function attempt<Value, E = unknown>(fn: () => Value): Result<Value, E>;
+export declare function attemptAsync<Value, E = unknown>(input: Promise<Value> | (() => Promise<Value>)): Promise<Result<Value, E>>;

package/x/ok/fns/attempt.js

@@ -0,0 +1,22 @@
+import { ok } from "./ok.js";
+import { err } from "./err.js";
+export function attempt(fn) {
+    try {
+        return ok(fn());
+    }
+    catch (error) {
+        return err(error);
+    }
+}
+export async function attemptAsync(input) {
+    try {
+        const promise = (typeof input === "function")
+            ? input()
+            : input;
+        return ok(await promise);
+    }
+    catch (error) {
+        return err(error);
+    }
+}
+//# sourceMappingURL=attempt.js.map

package/x/ok/fns/attempt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt.js","sourceRoot":"","sources":["../../../s/ok/fns/attempt.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,EAAE,EAAC,MAAM,SAAS,CAAA;AAC1B,OAAO,EAAC,GAAG,EAAC,MAAM,UAAU,CAAA;AAG5B,MAAM,UAAU,OAAO,CAAqB,EAAe;IAC1D,IAAI,CAAC;QACJ,OAAO,EAAE,CAAC,EAAE,EAAE,CAAC,CAAA;IAChB,CAAC;IACD,OAAO,KAAK,EAAE,CAAC;QACd,OAAO,GAAG,CAAC,KAAU,CAAC,CAAA;IACvB,CAAC;AACF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,KAA8C;IAG/C,IAAI,CAAC;QACJ,MAAM,OAAO,GAAG,CAAC,OAAO,KAAK,KAAK,UAAU,CAAC;YAC5C,CAAC,CAAC,KAAK,EAAE;YACT,CAAC,CAAC,KAAK,CAAA;QACR,OAAO,EAAE,CAAC,MAAM,OAAO,CAAC,CAAA;IACzB,CAAC;IACD,OAAO,KAAK,EAAE,CAAC;QACd,OAAO,GAAG,CAAC,KAAU,CAAC,CAAA;IACvB,CAAC;AACF,CAAC"}

package/x/ok/fns/err.d.ts

@@ -1,3 +1,3 @@
 import type { Err } from "../types/err.js";
 /** failure */
-export declare function err<E = string>(error: E): Err<E>;
+export declare function err<E>(error: E): Err<E>;

package/x/ok/fns/err.js.map

@@ -1 +1 @@
-{"version":3,"file":"err.js","sourceRoot":"","sources":["../../../s/ok/fns/err.ts"],"names":[],"mappings":"AAGA,cAAc;AACd,MAAM,UAAU,GAAG,CAAa,KAAQ;IACvC,OAAO,EAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAC,CAAA;AAC1B,CAAC"}
+{"version":3,"file":"err.js","sourceRoot":"","sources":["../../../s/ok/fns/err.ts"],"names":[],"mappings":"AAGA,cAAc;AACd,MAAM,UAAU,GAAG,CAAI,KAAQ;IAC9B,OAAO,EAAC,EAAE,EAAE,KAAK,EAAE,KAAK,EAAC,CAAA;AAC1B,CAAC"}

package/x/ok/fns/get.d.ts

@@ -0,0 +1,7 @@
+import type { Result } from "../types/result.js";
+/** get value or undefined */
+export declare function getOk<Value>(result: Result<Value, unknown>): Value | undefined;
+/** get error or undefined */
+export declare function getErr<E = unknown>(result: Result<unknown, E>): E | undefined;
+/** @deprecated renamed to `getOk` */
+export declare const grab: typeof getOk;

package/x/ok/fns/get.js

@@ -0,0 +1,15 @@
+/** get value or undefined */
+export function getOk(result) {
+    return result.ok
+        ? result.value
+        : undefined;
+}
+/** get error or undefined */
+export function getErr(result) {
+    return result.ok
+        ? undefined
+        : result.error;
+}
+/** @deprecated renamed to `getOk` */
+export const grab = getOk;
+//# sourceMappingURL=get.js.map

package/x/ok/fns/get.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get.js","sourceRoot":"","sources":["../../../s/ok/fns/get.ts"],"names":[],"mappings":"AAGA,6BAA6B;AAC7B,MAAM,UAAU,KAAK,CAAQ,MAA8B;IAC1D,OAAO,MAAM,CAAC,EAAE;QACf,CAAC,CAAC,MAAM,CAAC,KAAK;QACd,CAAC,CAAC,SAAS,CAAA;AACb,CAAC;AAED,6BAA6B;AAC7B,MAAM,UAAU,MAAM,CAAc,MAA0B;IAC7D,OAAO,MAAM,CAAC,EAAE;QACf,CAAC,CAAC,SAAS;QACX,CAAC,CAAC,MAAM,CAAC,KAAK,CAAA;AAChB,CAAC;AAED,qCAAqC;AACrC,MAAM,CAAC,MAAM,IAAI,GAAG,KAAK,CAAA"}

package/x/ok/fns/need.d.ts

@@ -1,3 +1,7 @@
 import type { Result } from "../types/result.js";
-/** get value or throw error */
-export declare function need<Value, E>(result: Result<Value, E>): Value;
+/** return ok value, otherwise throw error */
+export declare function needOk<Value, E>(result: Result<Value, E>): Value;
+/** return error, otherwise throw error */
+export declare function needErr<E>(result: Result<unknown, E>): E;
+/** @deprecated renamed to `needOk` */
+export declare const need: typeof needOk;

package/x/ok/fns/need.js

@@ -1,5 +1,5 @@
-/** get value or throw error */
-export function need(result) {
+/** return ok value, otherwise throw error */
+export function needOk(result) {
     if (result.ok)
         return result.value;
     const { error } = result;
@@ -10,4 +10,12 @@ export function need(result) {
     else
         throw new Error("unknown");
 }
+/** return error, otherwise throw error */
+export function needErr(result) {
+    if (result.ok)
+        throw new Error("didn't get needed error");
+    return result.error;
+}
+/** @deprecated renamed to `needOk` */
+export const need = needOk;
 //# sourceMappingURL=need.js.map

package/x/ok/fns/need.js.map

@@ -1 +1 @@
-{"version":3,"file":"need.js","sourceRoot":"","sources":["../../../s/ok/fns/need.ts"],"names":[],"mappings":"AAGA,+BAA+B;AAC/B,MAAM,UAAU,IAAI,CAAW,MAAwB;IACtD,IAAI,MAAM,CAAC,EAAE;QACZ,OAAO,MAAM,CAAC,KAAK,CAAA;IAEpB,MAAM,EAAC,KAAK,EAAC,GAAG,MAAM,CAAA;IAEtB,IAAI,KAAK,YAAY,KAAK;QACzB,MAAM,KAAK,CAAA;SAEP,IAAI,OAAO,KAAK,KAAK,QAAQ;QACjC,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAA;;QAGtB,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,CAAA;AAC5B,CAAC"}
+{"version":3,"file":"need.js","sourceRoot":"","sources":["../../../s/ok/fns/need.ts"],"names":[],"mappings":"AAGA,6CAA6C;AAC7C,MAAM,UAAU,MAAM,CAAW,MAAwB;IACxD,IAAI,MAAM,CAAC,EAAE;QACZ,OAAO,MAAM,CAAC,KAAK,CAAA;IAEpB,MAAM,EAAC,KAAK,EAAC,GAAG,MAAM,CAAA;IAEtB,IAAI,KAAK,YAAY,KAAK;QACzB,MAAM,KAAK,CAAA;SAEP,IAAI,OAAO,KAAK,KAAK,QAAQ;QACjC,MAAM,IAAI,KAAK,CAAC,KAAK,CAAC,CAAA;;QAGtB,MAAM,IAAI,KAAK,CAAC,SAAS,CAAC,CAAA;AAC5B,CAAC;AAED,0CAA0C;AAC1C,MAAM,UAAU,OAAO,CAAI,MAA0B;IACpD,IAAI,MAAM,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,yBAAyB,CAAC,CAAA;IACzD,OAAO,MAAM,CAAC,KAAK,CAAA;AACpB,CAAC;AAED,sCAAsC;AACtC,MAAM,CAAC,MAAM,IAAI,GAAG,MAAM,CAAA"}

package/x/ok/index.d.ts

@@ -1,6 +1,7 @@
+export * from "./fns/attempt.js";
 export * from "./fns/ok.js";
 export * from "./fns/err.js";
-export * from "./fns/grab.js";
+export * from "./fns/get.js";
 export * from "./fns/need.js";
 export * from "./types/ok.js";
 export * from "./types/err.js";

package/x/ok/index.js

@@ -1,6 +1,7 @@
+export * from "./fns/attempt.js";
 export * from "./fns/ok.js";
 export * from "./fns/err.js";
-export * from "./fns/grab.js";
+export * from "./fns/get.js";
 export * from "./fns/need.js";
 export * from "./types/ok.js";
 export * from "./types/err.js";

package/x/ok/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../s/ok/index.ts"],"names":[],"mappings":"AACA,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAC7B,cAAc,eAAe,CAAA;AAE7B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../s/ok/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAA;AAChC,cAAc,aAAa,CAAA;AAC3B,cAAc,cAAc,CAAA;AAC5B,cAAc,cAAc,CAAA;AAC5B,cAAc,eAAe,CAAA;AAE7B,cAAc,eAAe,CAAA;AAC7B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA"}

package/x/ok/test.d.ts

@@ -1,9 +1,13 @@
 declare const _default: {
     ok: import("@e280/science").Test;
     err: import("@e280/science").Test;
-    grab: import("@e280/science").Test;
-    need: import("@e280/science").Test;
-    "need error handling": {
+    getOk: import("@e280/science").Test;
+    getErr: import("@e280/science").Test;
+    needOk: import("@e280/science").Test;
+    needErr: import("@e280/science").Test;
+    attempt: import("@e280/science").Test;
+    attemptAsync: import("@e280/science").Test;
+    "needOk error handling": {
         "rethrows errors": import("@e280/science").Test;
         "upgrades strings to errors": import("@e280/science").Test;
         "everything else is unknown": import("@e280/science").Test;

package/x/ok/test.js

@@ -1,6 +1,6 @@
 import { expect, suite, test } from "@e280/science";
 import { thrown } from "../thrown.js";
-import { ok, err, grab, need } from "./index.js";
+import { ok, err, getOk, needOk, attempt, needErr, getErr, attemptAsync } from "./index.js";
 export default suite({
     "ok": test(async () => {
         expect(ok(123).ok).is(true);
@@ -12,27 +12,45 @@ export default suite({
         expect(err("nope").error).is("nope");
         expect("value" in err("nope")).is(false);
     }),
-    "grab": test(async () => {
-        expect(grab(ok(123))).is(123);
-        expect(grab(err("nope"))).is(undefined);
+    "getOk": test(async () => {
+        expect(getOk(ok(123))).is(123);
+        expect(getOk(err("nope"))).is(undefined);
     }),
-    "need": test(async () => {
-        expect(need(ok(123))).is(123);
-        expect(() => need(err("nope"))).throws();
+    "getErr": test(async () => {
+        expect(getErr(err("nope"))).is("nope");
+        expect(getErr(ok(123))).is(undefined);
     }),
-    "need error handling": {
+    "needOk": test(async () => {
+        expect(needOk(ok(123))).is(123);
+        expect(() => needOk(err("nope"))).throws();
+    }),
+    "needErr": test(async () => {
+        expect(needErr(err("nope"))).is("nope");
+        expect(() => needErr(ok(123))).throws();
+    }),
+    "attempt": test(async () => {
+        expect(needOk(attempt(() => 123))).is(123);
+        expect(attempt(() => { throw new Error("rofl"); }).ok).is(false);
+        expect(needErr(attempt(() => { throw new Error("rofl"); })).message).is("rofl");
+    }),
+    "attemptAsync": test(async () => {
+        expect(needOk(await attemptAsync(async () => 123))).is(123);
+        expect((await attemptAsync(async () => { throw new Error("rofl"); })).ok).is(false);
+        expect(needErr(await attemptAsync(async () => { throw new Error("rofl"); })).message).is("rofl");
+    }),
+    "needOk error handling": {
         "rethrows errors": test(async () => {
             const error = new TypeError();
-            expect(() => need(err(error))).throws(TypeError);
-            expect(thrown(() => need(err(error)))).is(error);
+            expect(() => needOk(err(error))).throws(TypeError);
+            expect(thrown(() => needOk(err(error)))).is(error);
         }),
         "upgrades strings to errors": test(async () => {
-            expect(() => need(err("nope"))).throws(Error);
-            expect(thrown(() => need(err("nope"))).message).is("nope");
+            expect(() => needOk(err("nope"))).throws(Error);
+            expect(thrown(() => needOk(err("nope"))).message).is("nope");
         }),
         "everything else is unknown": test(async () => {
-            expect(() => need(err({ code: 234 }))).throws(Error);
-            expect(thrown(() => need(err({ code: 234 }))).message).is("unknown");
+            expect(() => needOk(err({ code: 234 }))).throws(Error);
+            expect(thrown(() => needOk(err({ code: 234 }))).message).is("unknown");
         }),
     },
 });

package/x/ok/test.js.map

@@ -1 +1 @@
-{"version":3,"file":"test.js","sourceRoot":"","sources":["../../s/ok/test.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"test.js","sourceRoot":"","sources":["../../s/ok/test.ts"],"names":[],"mappings":"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"}

package/s/ok/fns/grab.ts

@@ -1,10 +0,0 @@
-
-import type {Result} from "../types/result.js"
-
-/** get value or undefined */
-export function grab<Value>(result: Result<Value, unknown>): Value | undefined {
-	return result.ok
-		? result.value
-		: undefined
-}
-

package/x/ok/fns/grab.d.ts

@@ -1,3 +0,0 @@
-import type { Result } from "../types/result.js";
-/** get value or undefined */
-export declare function grab<Value>(result: Result<Value, unknown>): Value | undefined;

package/x/ok/fns/grab.js

@@ -1,7 +0,0 @@
-/** get value or undefined */
-export function grab(result) {
-    return result.ok
-        ? result.value
-        : undefined;
-}
-//# sourceMappingURL=grab.js.map

package/x/ok/fns/grab.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"grab.js","sourceRoot":"","sources":["../../../s/ok/fns/grab.ts"],"names":[],"mappings":"AAGA,6BAA6B;AAC7B,MAAM,UAAU,IAAI,CAAQ,MAA8B;IACzD,OAAO,MAAM,CAAC,EAAE;QACf,CAAC,CAAC,MAAM,CAAC,KAAK;QACd,CAAC,CAAC,SAAS,CAAA;AACb,CAAC"}