retuple 1.0.0-next.29 → 1.0.0-next.30

package/dist/index.cjs

@@ -919,6 +919,43 @@ class ResultAsync {
     async $unwrap(msg) {
         return (await __classPrivateFieldGet(this, _ResultAsync_inner, "f")).$unwrap(msg);
     }
+    /**
+     * Resolves this `ResultAsync` using the provided resolver. The resolver
+     * receives a promise which resolves when the result is `Ok` and rejects if
+     * the result is `Err`.
+     *
+     * This method should only be called when the `E` type extends `Error`. This
+     * is enforced with a type constraint. If the error value is not an instance
+     * of Error, the promise rejects with `RetupleExpectFailed`.
+     *
+     * @example
+     *
+     * ```ts
+     * async function resolver(promise: Promise<URL>): string {
+     *   try {
+     *     const url = await promise;
+     *
+     *     return url.toString();
+     *   } catch (cause) {
+     *     throw new Error("Not a valid URL", { cause });
+     *   }
+     * }
+     *
+     * const urlString = await Result.$safeAsync(() => getDataAsync())
+     *   .$andSafe((data) => new URL(data.url))
+     *   .$resolve(resolver);
+     * ```
+     */
+    async $resolve(resolver) {
+        return __classPrivateFieldGet(this, _ResultAsync_inner, "f").then(async (result) => {
+            if (result instanceof ResultOk) {
+                return await resolver(Promise.resolve(result[1]));
+            }
+            return await resolver(Promise.reject(result[0] instanceof Error
+                ? result[0]
+                : new RetupleExpectFailed(result[0])));
+        });
+    }
     /**
      * The same as {@link Retuple.$unwrapErr|$unwrapErr}, except it returns
      * a `Promise`.

package/dist/index.d.cts

@@ -212,6 +212,34 @@ declare class ResultAsync<T, E> {
      * The same as {@link Retuple.$unwrap|$unwrap}, except it returns a `Promise`.
      */
     $unwrap(this: ResultAsync<T, E>, msg?: string): Promise<T>;
+    /**
+     * Resolves this `ResultAsync` using the provided resolver. The resolver
+     * receives a promise which resolves when the result is `Ok` and rejects if
+     * the result is `Err`.
+     *
+     * This method should only be called when the `E` type extends `Error`. This
+     * is enforced with a type constraint. If the error value is not an instance
+     * of Error, the promise rejects with `RetupleExpectFailed`.
+     *
+     * @example
+     *
+     * ```ts
+     * async function resolver(promise: Promise<URL>): string {
+     *   try {
+     *     const url = await promise;
+     *
+     *     return url.toString();
+     *   } catch (cause) {
+     *     throw new Error("Not a valid URL", { cause });
+     *   }
+     * }
+     *
+     * const urlString = await Result.$safeAsync(() => getDataAsync())
+     *   .$andSafe((data) => new URL(data.url))
+     *   .$resolve(resolver);
+     * ```
+     */
+    $resolve<U = T>(this: ResultAsync<T, Error>, resolver: (promise: Promise<T>) => PromiseLike<U>): Promise<U>;
     /**
      * The same as {@link Retuple.$unwrapErr|$unwrapErr}, except it returns
      * a `Promise`.

package/dist/index.d.ts

@@ -212,6 +212,34 @@ declare class ResultAsync<T, E> {
      * The same as {@link Retuple.$unwrap|$unwrap}, except it returns a `Promise`.
      */
     $unwrap(this: ResultAsync<T, E>, msg?: string): Promise<T>;
+    /**
+     * Resolves this `ResultAsync` using the provided resolver. The resolver
+     * receives a promise which resolves when the result is `Ok` and rejects if
+     * the result is `Err`.
+     *
+     * This method should only be called when the `E` type extends `Error`. This
+     * is enforced with a type constraint. If the error value is not an instance
+     * of Error, the promise rejects with `RetupleExpectFailed`.
+     *
+     * @example
+     *
+     * ```ts
+     * async function resolver(promise: Promise<URL>): string {
+     *   try {
+     *     const url = await promise;
+     *
+     *     return url.toString();
+     *   } catch (cause) {
+     *     throw new Error("Not a valid URL", { cause });
+     *   }
+     * }
+     *
+     * const urlString = await Result.$safeAsync(() => getDataAsync())
+     *   .$andSafe((data) => new URL(data.url))
+     *   .$resolve(resolver);
+     * ```
+     */
+    $resolve<U = T>(this: ResultAsync<T, Error>, resolver: (promise: Promise<T>) => PromiseLike<U>): Promise<U>;
     /**
      * The same as {@link Retuple.$unwrapErr|$unwrapErr}, except it returns
      * a `Promise`.

package/dist/index.js

@@ -905,6 +905,43 @@ class ResultAsync {
     async $unwrap(msg) {
         return (await __classPrivateFieldGet(this, _ResultAsync_inner, "f")).$unwrap(msg);
     }
+    /**
+     * Resolves this `ResultAsync` using the provided resolver. The resolver
+     * receives a promise which resolves when the result is `Ok` and rejects if
+     * the result is `Err`.
+     *
+     * This method should only be called when the `E` type extends `Error`. This
+     * is enforced with a type constraint. If the error value is not an instance
+     * of Error, the promise rejects with `RetupleExpectFailed`.
+     *
+     * @example
+     *
+     * ```ts
+     * async function resolver(promise: Promise<URL>): string {
+     *   try {
+     *     const url = await promise;
+     *
+     *     return url.toString();
+     *   } catch (cause) {
+     *     throw new Error("Not a valid URL", { cause });
+     *   }
+     * }
+     *
+     * const urlString = await Result.$safeAsync(() => getDataAsync())
+     *   .$andSafe((data) => new URL(data.url))
+     *   .$resolve(resolver);
+     * ```
+     */
+    async $resolve(resolver) {
+        return __classPrivateFieldGet(this, _ResultAsync_inner, "f").then(async (result) => {
+            if (result instanceof ResultOk) {
+                return await resolver(Promise.resolve(result[1]));
+            }
+            return await resolver(Promise.reject(result[0] instanceof Error
+                ? result[0]
+                : new RetupleExpectFailed(result[0])));
+        });
+    }
     /**
      * The same as {@link Retuple.$unwrapErr|$unwrapErr}, except it returns
      * a `Promise`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "retuple",
-  "version": "1.0.0-next.29",
+  "version": "1.0.0-next.30",
   "scripts": {
     "test": "vitest",
     "lint": "eslint . --ext .ts -c eslint.config.mjs --fix",