cafe-utility 4.13.2 → 4.15.0

package/index.d.ts

@@ -20,7 +20,7 @@ declare function randomIntInclusive(min: number, max: number): number;
 declare function randomBetween(min: number, max: number): number;
 declare function signedRandom(): number;
 declare function chance(threshold: number): boolean;
-declare function pick<T>(array: T[]): T;
+declare function pick<T>(array: T[], generator?: () => number): T;
 declare function last<T>(array: T[]): T;
 declare function pickWeighted<T>(array: T[], weights: number[], randomNumber?: number): T;
 declare function sortWeighted<T>(array: T[], weights: number[]): T[];
@@ -57,6 +57,7 @@ declare function isUndefined(value: any): value is undefined;
 declare function isFunction(value: any): value is Function;
 declare function isString(value: any): value is string;
 declare function isNumber(value: any): value is number;
+declare function isBoolean(value: any): value is boolean;
 declare function isDate(value: any): value is Date;
 declare function isBlank(value: any): boolean;
 declare function isId(value: any): value is number | string;
@@ -67,6 +68,7 @@ declare function randomUnicodeString(length: number): string;
 declare function randomHexString(length: number): string;
 declare function asString(string: any): string;
 declare function asNumber(number: any): number;
+declare function asBoolean(bool: any): boolean;
 declare function asDate(date: any): Date;
 declare function asNullableString(string: any): string | null;
 declare function asId(value: any): number;
@@ -445,11 +447,13 @@ export declare const Types: {
     isUndefined: typeof isUndefined;
     isString: typeof isString;
     isNumber: typeof isNumber;
+    isBoolean: typeof isBoolean;
     isDate: typeof isDate;
     isBlank: typeof isBlank;
     isId: typeof isId;
     asString: typeof asString;
     asNumber: typeof asNumber;
+    asBoolean: typeof asBoolean;
     asDate: typeof asDate;
     asNullableString: typeof asNullableString;
     asId: typeof asId;

package/index.js

@@ -112,8 +112,8 @@ function chance(threshold) {
     return Math.random() < threshold
 }
 
-function pick(array) {
-    return array[Math.floor(array.length * Math.random())]
+function pick(array, generator = Math.random) {
+    return array[Math.floor(array.length * generator())]
 }
 
 function last(array) {
@@ -387,6 +387,10 @@ function isNumber(value) {
     return !isNaN(value) && String(value) === String(parseFloat(value))
 }
 
+function isBoolean(value) {
+    return value === true || value === false
+}
+
 function isDate(value) {
     return Object.prototype.toString.call(value) === '[object Date]'
 }
@@ -459,6 +463,13 @@ function asNumber(number) {
     return number
 }
 
+function asBoolean(bool) {
+    if (!isBoolean(bool)) {
+        throw new TypeError('Expected boolean, got: ' + bool)
+    }
+    return bool
+}
+
 function asDate(date) {
     if (!isDate(date)) {
         throw new TypeError('Expected date, got: ' + date)
@@ -1931,11 +1942,13 @@ exports.Types = {
     isUndefined,
     isString,
     isNumber,
+    isBoolean,
     isDate,
     isBlank,
     isId,
     asString,
     asNumber,
+    asBoolean,
     asDate,
     asNullableString,
     asId,

package/package.json

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