cafe-utility 13.2.0 → 13.3.0

package/index.d.ts

@@ -72,6 +72,8 @@ declare function asId(value: any): number;
 declare function asTime(value: any): string;
 declare function asArray(value: any): unknown[];
 declare function asObject(value: any): Record<string, unknown>;
+declare function isNullable(typeFn: (value: any) => boolean, value: any): boolean;
+declare function asNullable<T>(typeFn: (value: any) => T, value: any): T | null;
 declare function enforceObjectShape(value: Record<string, any>, shape: Record<string, (value: any) => boolean>): boolean;
 declare function enforceArrayShape(value: any[], shape: Record<string, (value: any) => boolean>): boolean;
 declare function represent(value: any, strategy?: 'json' | 'key-value', depth?: number): string;
@@ -563,6 +565,7 @@ export declare const Types: {
     isDate: typeof isDate;
     isBlank: typeof isBlank;
     isId: typeof isId;
+    isNullable: typeof isNullable;
     asString: typeof asString;
     asNumber: typeof asNumber;
     asInteger: typeof asInteger;
@@ -574,6 +577,7 @@ export declare const Types: {
     asTime: typeof asTime;
     asArray: typeof asArray;
     asObject: typeof asObject;
+    asNullable: typeof asNullable;
     enforceObjectShape: typeof enforceObjectShape;
     enforceArrayShape: typeof enforceArrayShape;
 };

package/index.js

@@ -385,6 +385,12 @@ function asObject(n) {
     if (!isStrictlyObject(n)) throw new TypeError('Expected object, got: ' + n)
     return n
 }
+function isNullable(n, e) {
+    return isUndefined(e) || e === null ? !0 : n(e)
+}
+function asNullable(n, e) {
+    return e === null || isUndefined(e) ? null : n(e)
+}
 function enforceObjectShape(n, e) {
     for (const [t, r] of Object.entries(e)) if (!r(n[t])) throw TypeError(`${t} in value does not exist or match shape`)
     for (const t of Object.keys(n)) if (!e[t]) throw TypeError(`${t} exists in value but not in shape`)
@@ -2062,6 +2068,7 @@ function raycastCircle(n, e, t) {
         isDate,
         isBlank,
         isId,
+        isNullable,
         asString,
         asNumber,
         asInteger,
@@ -2073,6 +2080,7 @@ function raycastCircle(n, e, t) {
         asTime,
         asArray,
         asObject,
+        asNullable,
         enforceObjectShape,
         enforceArrayShape
     }),

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "cafe-utility",
-    "version": "13.2.0",
+    "version": "13.3.0",
     "description": "",
     "main": "index.js",
     "exports": {