Optional properties

package.json

@@ -66,7 +66,8 @@
     "test": "yarn build:types && yarn test:types && yarn build:cjs && yarn test:mocha",
     "test:mocha": "mocha --require ./test/register.cjs --require source-map-support/register ./test/index.ts",
     "test:types": "tsc --noEmit && tsc --project ./test/tsconfig.json --noEmit",
-    "watch": "yarn build:cjs --watch"
+    "watch": "yarn build:cjs --watch",
+    "watch:types": "yarn build:types --watch"
   },
   "keywords": [
     "api",

src/types.ts

@@ -249,6 +249,37 @@ export function number(): Struct<number> {
   })
 }
 
+/**
+ * Type helper to Flatten the Union of optional and required properties.
+ */
+
+type Flatten<T> = T extends infer U ? { [K in keyof U]: U[K] } : never
+
+/**
+ * Type helper to extract the optional keys of an object
+ */
+
+type OptionalKeys<T> = {
+  [K in keyof T]: undefined extends T[K] ? K : never
+}[keyof T]
+
+/**
+ * Type helper to extract the required keys of an object
+ */
+
+type RequiredKeys<T> = {
+  [K in keyof T]: undefined extends T[K] ? never : K
+}[keyof T]
+
+/**
+ * Type helper to create optional properties when the property value can be
+ * undefined (ie. when `optional()` is used to define a type)
+ */
+
+type OptionalizeObject<T> = Flatten<
+  { [K in RequiredKeys<T>]: T[K] } & { [K in OptionalKeys<T>]?: T[K] }
+>
+
 /**
  * Validate that an object with specific entry values.
  */
@@ -258,7 +289,7 @@ export function object<V extends StructRecord<any>>(): Struct<
 >
 export function object<V extends StructRecord<any>>(
   Structs: V
-): Struct<{ [K in keyof V]: StructType<V[K]> }, V>
+): Struct<OptionalizeObject<{ [K in keyof V]: StructType<V[K]> }>, V>
 export function object<V extends StructRecord<any>>(
   Structs?: V
 ): Struct<any, any> {

test/types/object.ts

@@ -1,4 +1,4 @@
-import { assert, object, number } from '../..'
+import { assert, object, optional, number, string } from '../..'
 import { test } from '..'
 
 test<Record<string, unknown>>((x) => {
@@ -10,3 +10,8 @@ test<{ a: number }>((x) => {
   assert(x, object({ a: number() }))
   return x
 })
+
+test<{ a?: number }>((x) => {
+  assert(x, object({ a: optional(number()) }))
+  return x
+})

test/types/optional.ts

@@ -6,7 +6,7 @@ test<string | undefined>((x) => {
   return x
 })
 
-test<{ a: string | undefined }>((x) => {
+test<{ a?: string | undefined }>((x) => {
   assert(x, object({ a: optional(string()) }))
   return x
 })