feat: Allow async error mappers (#8)

README.md

@@ -220,7 +220,7 @@ that is likely more specific.
 The `TypicalHttpError` includes the `Response` object so consumers can extract
 more information from it as needed. The default error handing will not have
 called the `.text()` and `.json()`methods on the response, so these can bue used
-when parsing the error.
+when parsing the error. Error mappers are allowed to be asynchronous.
 
 ```typescript
 const fetcher = buildCall() //

src/__tests__/index.test.ts

@@ -1163,6 +1163,54 @@ describe('call builder', () => {
       expect(scope.isDone()).toEqual(true);
     });
 
+    it('async error mapper', async () => {
+      const scope = nock(baseUrl) //
+        .get('/boop')
+        .reply(500);
+
+      const fetcher = buildCall()
+        .path('/boop')
+        .method('get')
+        .mapError(async (_err) => {
+          await new Promise((res) => setTimeout(res, 1));
+          return 'async arrar!';
+        })
+        .build();
+
+      const res = await fetcher({ baseUrl });
+
+      expect(res.success).toEqual(false);
+      expect(res?.error).toEqual('async arrar!');
+      expect(res?.error).toMatchInlineSnapshot(`"async arrar!"`);
+      expect(scope.isDone()).toEqual(true);
+    });
+
+    it('mixed sync and async error mapper', async () => {
+      const scope = nock(baseUrl) //
+        .get('/boop')
+        .reply(500);
+
+      const fetcher = buildCall()
+        .path('/boop')
+        .method('get')
+        .mapError((_) => 'error!')
+        .mapError(async (err) => {
+          console.log(err);
+          await new Promise((res) => setTimeout(res, 1));
+          return err.toUpperCase();
+        })
+
+        .mapError((err) => `${err}!!11`)
+        .build();
+
+      const res = await fetcher({ baseUrl });
+
+      expect(res.success).toEqual(false);
+      expect(res?.error).toEqual('ERROR!!!11');
+      expect(res?.error).toMatchInlineSnapshot(`"ERROR!!!11"`);
+      expect(scope.isDone()).toEqual(true);
+    });
+
     it.todo('runtype failure');
   });
 });

src/common.ts

@@ -84,14 +84,14 @@ export function getFetchParams(
   return { url, headers, body };
 }
 
-export function applyErrorMappers(
+export async function applyErrorMappers(
   error: any,
   mappers: CallRecord['errorMappers'],
   args: any,
 ) {
   let newError = error;
   for (const mapper of mappers) {
-    newError = mapper(newError, args);
+    newError = await mapper(newError, args);
   }
   return newError;
 }

src/index.ts

@@ -19,7 +19,7 @@ export { unwrapError } from './common';
 export class CallBuilder<
   Ret = void,
   Arg extends Record<string, any> = { baseUrl: string | URL },
-  Err = TypicalWrappedError | TypicalHttpError,
+  Err = TypicalWrappedError | TypicalHttpError
 > {
   private record: CallRecord;
 
@@ -145,7 +145,9 @@ export class CallBuilder<
    * called multiple times. Each map function will receive the result of the
    * previous mapper.
    */
-  mapError<T>(mapper: (error: Err, args: Arg) => T): CallBuilder<Ret, Arg, T> {
+  mapError<T>(
+    mapper: (error: Err, args: Arg) => T | Promise<T>,
+  ): CallBuilder<Ret, Arg, T> {
     return new CallBuilder<Ret, Arg, T>({
       ...this.record,
       errorMappers: [...this.record.errorMappers, mapper],
@@ -273,7 +275,7 @@ export class CallBuilder<
           return {
             success: false,
             body: undefined,
-            error: applyErrorMappers(
+            error: await applyErrorMappers(
               new TypicalHttpError(res),
               errorMappers,
               args,
@@ -307,7 +309,7 @@ export class CallBuilder<
         return {
           success: false,
           body: undefined,
-          error: applyErrorMappers(
+          error: await applyErrorMappers(
             new TypicalWrappedError(error, res, text),
             errorMappers,
             args,