Add PromiseValue type

index.d.ts

@@ -15,6 +15,7 @@ export {Promisable} from './source/promisable';
 export {Opaque} from './source/opaque';
 export {SetOptional} from './source/set-optional';
 export {SetRequired} from './source/set-required';
+export {PromiseValue} from './source/promise-value';
 
 // Miscellaneous
 export {PackageJson} from './source/package-json';

readme.md

@@ -74,6 +74,7 @@ Click the type names for complete docs.
 - [`Opaque`](source/opaque.d.ts) - Create an [opaque type](https://codemix.com/opaque-types-in-javascript/).
 - [`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.
 
 ### Miscellaneous
 

source/promise-value.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Returns the type that is wrapped inside a `Promise` type.
+ * If the type is not a `Promise`, the type itself is returned.
+ *
+ * @example
+ * import { asyncFunction } from 'api';
+ * import { PromiseValue } from 'type-fest';
+ *
+ * let data: PromiseValue<ReturnType<typeof asyncFunction>>;
+ *
+ * async function setValue () {
+ *   data = await asyncFunction();
+ * }
+ *
+ * setValue();
+ *
+ * // Here's an example of using this with non-Promise types.
+ * function getNumber () {
+ *  return 2;
+ * }
+ *
+ * let number: PromiseValue<ReturnType<typeof getNumber>> = getNumber();
+ */
+export type PromiseValue<PromiseType, Otherwise = PromiseType> = PromiseType extends Promise<infer Value> ? Value : Otherwise;

test-d/promise-value.ts

@@ -0,0 +1,14 @@
+import {expectType} from 'tsd';
+import {PromiseValue} from '..';
+
+type NumberPromise = Promise<number>;
+type Otherwise = object;
+
+// Test the normal behaviour.
+expectType<PromiseValue<NumberPromise>>(2);
+
+// Test what happens when the `PromiseValue` type is not handed a `Promise` type.
+expectType<PromiseValue<number>>(2);
+
+// Test the `Otherwise` generic parameter.
+expectType<PromiseValue<number, Otherwise>>({});