feat(types): Tryit

Signed-off-by: Lexus Drumgold <[email protected]>

.dictionary.txt

@@ -29,6 +29,7 @@ pkgs
 preid
 promisable
 stringafiable
+tryit
 tscu
 unstub
 vates

src/types/__tests__/tryit.spec-d.ts

@@ -0,0 +1,20 @@
+/**
+ * @file Type Tests - Tryit
+ * @module tutils/types/tests/unit-d/Tryit
+ */
+
+import type Book from '#fixtures/book.interface'
+import type NumberString from '../number-string'
+import type TestSubject from '../tryit'
+
+describe('unit-d:types/Tryit', () => {
+  it('should convert T to error-first callback', () => {
+    // Arrange
+    type T = (id: NumberString) => Promise<Book>
+    type R = Promise<[Error, null] | [null, Awaited<ReturnType<T>>]>
+
+    // Expect
+    expectTypeOf<TestSubject<T>>().parameters.toEqualTypeOf<Parameters<T>>
+    expectTypeOf<TestSubject<T>>().returns.toEqualTypeOf<R>
+  })
+})

src/types/index.ts

@@ -105,6 +105,7 @@ export type { default as TimestampFormat } from './timestamp-format'
 export type { default as Trim } from './trim'
 export type { default as TrimEnd } from './trim-end'
 export type { default as TrimStart } from './trim-start'
+export type { default as Tryit } from './tryit'
 export type { default as TupleLength } from './tuple-length'
 export type { default as TupleToUnion } from './tuple-to-union'
 export type { default as TypedArray } from './typed-array'

src/types/promisable.ts

@@ -4,11 +4,11 @@
  */
 
 /**
- * Type representing an awaitable or synchronous value.
+ * An awaitable or synchronous value.
  *
  * @see https://github.com/microsoft/TypeScript/issues/31394
  *
- * @template T - Value type
+ * @template T - Type to evalute
  */
 type Promisable<T> = PromiseLike<T> | T
 

src/types/tryit.ts

@@ -0,0 +1,19 @@
+/**
+ * @file Type Definitions - Tryit
+ * @module tutils/types/Tryit
+ */
+
+import type Fn from './fn'
+
+/**
+ * Converts `T` to an error-first callback.
+ *
+ * @template T - Function to convert
+ * @template E - Error type
+ */
+type Tryit<T extends Fn, E extends Error = Error> = Fn<
+  Parameters<T>,
+  Promise<[E, null] | [null, Awaited<ReturnType<T>>]>
+>
+
+export type { Tryit as default }