@infra-blocks/types 0.32.0 → 0.33.0-alpha.0

package/lib/cjs/types.d.ts

@@ -27,6 +27,10 @@ export type Brand<T extends PropertyKey = PropertyKey> = {
         [k in T]: true;
     };
 };
+/**
+ * A type alias for {@link NotUndefined}, because double negation sucks azz.
+ */
+export type Defined<T> = Exclude<T, undefined>;
 /**
  * Convenience type to represent environment variables.
  */
@@ -36,11 +40,26 @@ export type EnvironmentVariables = Record<string, string | undefined>;
  */
 export type EnvVars = EnvironmentVariables;
 /**
- * Convenient type alias to regroup a type that can be T, null or undefined.
+ * A type representing nil types, also known as "nullable" types in Typescript
+ * utility types terminology.
+ */
+export type Nil = null | undefined;
+/**
+ * A type utility excluding `null` and `undefined` from `T`.
  *
- * Semantically the opposite of {@link NonNullable}.
+ * This is an alias for the built-in `NonNullable` utility type. It is only provided
+ * so that calling code can revolve around the same naming conventions with regards
+ * to `null | undefined` types.
+ */
+export type NotNil<T> = NonNullable<T>;
+/**
+ * A type utility excluding `null` from `T`.
+ */
+export type NotNull<T> = Exclude<T, null>;
+/**
+ * Excludes `undefined` from `T`.
  */
-export type Nullable<T> = T | null | undefined;
+export type NotUndefined<T> = Exclude<T, undefined>;
 /**
  * A utility type for tracking a phantom type parameter.
  */

package/lib/esm/types.d.ts

@@ -27,6 +27,10 @@ export type Brand<T extends PropertyKey = PropertyKey> = {
         [k in T]: true;
     };
 };
+/**
+ * A type alias for {@link NotUndefined}, because double negation sucks azz.
+ */
+export type Defined<T> = Exclude<T, undefined>;
 /**
  * Convenience type to represent environment variables.
  */
@@ -36,11 +40,26 @@ export type EnvironmentVariables = Record<string, string | undefined>;
  */
 export type EnvVars = EnvironmentVariables;
 /**
- * Convenient type alias to regroup a type that can be T, null or undefined.
+ * A type representing nil types, also known as "nullable" types in Typescript
+ * utility types terminology.
+ */
+export type Nil = null | undefined;
+/**
+ * A type utility excluding `null` and `undefined` from `T`.
  *
- * Semantically the opposite of {@link NonNullable}.
+ * This is an alias for the built-in `NonNullable` utility type. It is only provided
+ * so that calling code can revolve around the same naming conventions with regards
+ * to `null | undefined` types.
+ */
+export type NotNil<T> = NonNullable<T>;
+/**
+ * A type utility excluding `null` from `T`.
+ */
+export type NotNull<T> = Exclude<T, null>;
+/**
+ * Excludes `undefined` from `T`.
  */
-export type Nullable<T> = T | null | undefined;
+export type NotUndefined<T> = Exclude<T, undefined>;
 /**
  * A utility type for tracking a phantom type parameter.
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@infra-blocks/types",
-  "version": "0.32.0",
+  "version": "0.33.0-alpha.0",
   "description": "Typescript types utility package.",
   "keywords": [
     "type",