yield-result 0.1.3 → 0.1.4

package/README.md

@@ -277,9 +277,9 @@ safe.sync(function* () {
 * **`err(error)`** / **`Result.err(error)`** — Creates an `Err<E>` result.
 * **`isOk(result)`** / **`isErr(result)`** — TypeScript type guards.
 
-### Flow Runners (`safe`)
-* **`safe.sync(function* () { ... })`** — Executes a synchronous generator function with early-return short-circuiting on `Err`.
-* **`safe.async(async function* () { ... })`** — Executes an async generator function with early-return short-circuiting on `Err`.
+### Flow Runners (`safe` & `Result.gen`)
+* **`safe.sync(function* () { ... })`** / **`Result.gen(function* () { ... })`** — Executes a synchronous generator function with early-return short-circuiting on `Err`.
+* **`safe.async(async function* () { ... })`** / **`Result.gen.async(async function* () { ... })`** — Executes an async generator function with early-return short-circuiting on `Err`.
 
 ### Exception Wrappers
 * **`fromThrowable(fn, errorMapper?)`** — Wraps a throwing function into a `Result<T, E>`.

package/dist/types.d.ts

@@ -98,7 +98,7 @@ export interface TaggedError<T extends string> {
  */
 export declare const taggedError: <T extends string, P extends Record<string, unknown> = {}>(tag: T, props?: P) => Readonly<TaggedError<T> & P>;
 /**
- * Namespace object grouping all Result constructors, guards, and combinators.
+ * Namespace object grouping all Result constructors, guards, combinators, and generator runners.
  */
 export declare const Result: {
     readonly ok: <T>(value: T) => Ok<T>;
@@ -123,4 +123,8 @@ export declare const Result: {
         errors: E[];
     };
     readonly taggedError: <T extends string, P extends Record<string, unknown> = {}>(tag: T, props?: P) => Readonly<TaggedError<T> & P>;
+    readonly gen: (<G extends Generator<Err<unknown>, unknown, unknown>>(fn: () => G) => Result<G extends Generator<unknown, infer R, unknown> ? R : G extends AsyncGenerator<unknown, infer R_1, unknown> ? R_1 : never, G extends Generator<infer Y, unknown, unknown> ? Y extends Err<infer E> ? E : never : G extends AsyncGenerator<infer Y_1, unknown, unknown> ? Y_1 extends Err<infer E_1> ? E_1 : never : never>) & {
+        sync: <G extends Generator<Err<unknown>, unknown, unknown>>(fn: () => G) => Result<G extends Generator<unknown, infer R, unknown> ? R : G extends AsyncGenerator<unknown, infer R_1, unknown> ? R_1 : never, G extends Generator<infer Y, unknown, unknown> ? Y extends Err<infer E> ? E : never : G extends AsyncGenerator<infer Y_1, unknown, unknown> ? Y_1 extends Err<infer E_1> ? E_1 : never : never>;
+        async: <G extends AsyncGenerator<Err<unknown>, unknown, unknown>>(fn: () => G) => Promise<Result<G extends Generator<unknown, infer R, unknown> ? R : G extends AsyncGenerator<unknown, infer R_1, unknown> ? R_1 : never, G extends Generator<infer Y, unknown, unknown> ? Y extends Err<infer E> ? E : never : G extends AsyncGenerator<infer Y_1, unknown, unknown> ? Y_1 extends Err<infer E_1> ? E_1 : never : never>>;
+    };
 };

package/dist/types.js

@@ -140,8 +140,13 @@ export const taggedError = (tag, props) => Object.freeze({
     _tag: tag,
     ...(props ?? {}),
 });
+import { safe } from "./flow.js";
+const genRunner = Object.assign((fn) => safe.sync(fn), {
+    sync: safe.sync,
+    async: safe.async,
+});
 /**
- * Namespace object grouping all Result constructors, guards, and combinators.
+ * Namespace object grouping all Result constructors, guards, combinators, and generator runners.
  */
 export const Result = {
     ok,
@@ -160,4 +165,5 @@ export const Result = {
     all,
     partition,
     taggedError,
+    gen: genRunner,
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "yield-result",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "Rust-style ? operator for TypeScript using generators (yield*). Zero dependencies, type-safe error handling.",
   "type": "module",
   "main": "./dist/index.js",