Add AsyncReturnType type

index.d.ts

@@ -16,6 +16,7 @@ export {Opaque} from './source/opaque';
 export {SetOptional} from './source/set-optional';
 export {SetRequired} from './source/set-required';
 export {PromiseValue} from './source/promise-value';
+export {AsyncReturnType} from './source/async-return-type';
 
 // Miscellaneous
 export {PackageJson} from './source/package-json';

readme.md

@@ -75,6 +75,7 @@ Click the type names for complete docs.
 - [`SetOptional`](source/set-optional.d.ts) - Create a type that makes the given keys optional.
 - [`SetRequired`](source/set-required.d.ts) - Create a type that makes the given keys required.
 - [`PromiseValue`](source/promise-value.d.ts) - Returns the type that is wrapped inside a `Promise` type.
+- [`AsyncReturnType`](source/async-return-type.d.ts) - Unpack the return type of a function that returns a `Promise`.
 
 ### Miscellaneous
 

source/async-return-type.d.ts

@@ -0,0 +1,19 @@
+import {PromiseValue} from './promise-value';
+
+type AsyncFunction = (...args: unknown[]) => Promise<unknown>;
+
+/**
+Unpack the return type of a function that returns a `Promise`.
+
+@example
+```ts
+import {AsyncReturnType} from 'type-fest';
+import {asyncFunction} from 'api';
+
+// This type resolves to the unpacked return type of `asyncFunction`.
+type Value = AsyncReturnType<typeof asyncFunction>;
+
+let value: Value = await asyncFunction();
+```
+ */
+export type AsyncReturnType<Target extends AsyncFunction> = PromiseValue<ReturnType<Target>>;

test-d/async-return-type.ts

@@ -0,0 +1,12 @@
+import {expectType} from 'tsd';
+import {AsyncReturnType} from '..';
+
+async function asyncFunction(): Promise<number> {
+    return Promise.resolve(2);
+}
+
+type Value = AsyncReturnType<typeof asyncFunction>;
+
+asyncFunction().then(value => {
+    expectType<Value>(value);
+});