@mongez/reinforcements 2.2.1 → 2.2.3

package/cjs/array/countBy.d.ts

@@ -1,5 +1,7 @@
 /**
  * Count the occurrences of values in an array for the given key
  */
-export default function countBy(array: any[], key: string): any;
+export default function countBy(array: any[], key: string): {
+    [key: string]: number;
+};
 //# sourceMappingURL=countBy.d.ts.map

package/cjs/array/countBy.js

@@ -0,0 +1,23 @@
+"use strict";
+
+var get = require("../object/get.js");
+
+/**
+ * Count the occurrences of values in an array for the given key
+ */
+function countBy(array, key) {
+  if (!Array.isArray(array)) {
+    return {};
+  }
+  return array.reduce((result, item) => {
+    const value = get(item, key);
+    if (result[value]) {
+      result[value]++;
+    } else {
+      result[value] = 1;
+    }
+    return result;
+  }, {});
+}
+
+module.exports = countBy;

package/cjs/array/pushUnique.d.ts

@@ -2,5 +2,5 @@
  * Push once one or more values to the array if and
  * only if the value doesn't exists in the array
  */
-export default function pushUnique<T>(array: T[], ...items: T[]): T[];
+export default function pushUnique<T = any>(array: T[], ...items: T[]): T[];
 //# sourceMappingURL=pushUnique.d.ts.map

package/cjs/array/unshiftUnique.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Prepend once one or more values to the array if and
+ * only if the value doesn't exists in the array
+ */
+export default function unshiftUnique<T = any>(array: T[], ...items: T[]): T[];
+//# sourceMappingURL=unshiftUnique.d.ts.map

package/cjs/array/unshiftUnique.js

@@ -0,0 +1,16 @@
+"use strict";
+
+/**
+ * Prepend once one or more values to the array if and
+ * only if the value doesn't exists in the array
+ */
+function unshiftUnique(array, ...items) {
+  items.forEach(item => {
+    if (!array.includes(item)) {
+      array.unshift(item);
+    }
+  });
+  return array;
+}
+
+module.exports = unshiftUnique;

package/cjs/index.d.ts

@@ -1,6 +1,7 @@
 export { default as average, default as avg } from "./array/average";
 export { default as chunk } from "./array/chunk";
 export { default as count } from "./array/count";
+export { default as countBy } from "./array/countBy";
 export { default as even } from "./array/even";
 export { default as evenIndexes } from "./array/evenIndexes";
 export { default as groupBy } from "./array/groupBy";
@@ -13,6 +14,7 @@ export { default as pluck } from "./array/pluck";
 export { default as pushUnique } from "./array/pushUnique";
 export { default as sum } from "./array/sum";
 export { default as unique } from "./array/unique";
+export { default as unshiftUnique } from "./array/unshiftUnique";
 export { default as areEqual } from "./mixed/areEqual/areEqual";
 export { default as clone } from "./mixed/clone/clone";
 export { default as shuffle } from "./mixed/shuffle/shuffle";
@@ -22,10 +24,10 @@ export { default as flatten } from "./object/flatten";
 export { default as get } from "./object/get";
 export { default as map } from "./object/map";
 export { default as merge } from "./object/merge";
-export { default as Obj } from "./object/obj";
 export { default as only } from "./object/only";
 export { default as set } from "./object/set";
 export { default as sort } from "./object/sort";
+export { default as unset } from "./object/unset";
 export { default as Random } from "./Random/random";
 export { default as capitalize } from "./string/capitalize";
 export { default as extension } from "./string/extension";

package/cjs/index.js

@@ -5,6 +5,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 var average = require("./array/average.js");
 var chunk = require("./array/chunk.js");
 var count = require("./array/count.js");
+var countBy = require("./array/countBy.js");
 var even = require("./array/even.js");
 var evenIndexes = require("./array/evenIndexes.js");
 var groupBy = require("./array/groupBy.js");
@@ -17,6 +18,7 @@ var pluck = require("./array/pluck.js");
 var pushUnique = require("./array/pushUnique.js");
 var sum = require("./array/sum.js");
 var unique = require("./array/unique.js");
+var unshiftUnique = require("./array/unshiftUnique.js");
 var areEqual = require("./mixed/areEqual/areEqual.js");
 var clone = require("./mixed/clone/clone.js");
 var shuffle = require("./mixed/shuffle/shuffle.js");
@@ -26,10 +28,10 @@ var flatten = require("./object/flatten.js");
 var get = require("./object/get.js");
 var map = require("./object/map.js");
 var merge = require("./object/merge.js");
-var obj = require("./object/obj.js");
 var only = require("./object/only.js");
 var set = require("./object/set.js");
 var sort = require("./object/sort.js");
+var unset = require("./object/unset.js");
 var random = require("./Random/random.js");
 var capitalize = require("./string/capitalize.js");
 var extension = require("./string/extension.js");
@@ -58,6 +60,7 @@ exports.average = average;
 exports.avg = average;
 exports.chunk = chunk;
 exports.count = count;
+exports.countBy = countBy;
 exports.even = even;
 exports.evenIndexes = evenIndexes;
 exports.groupBy = groupBy;
@@ -70,6 +73,7 @@ exports.pluck = pluck;
 exports.pushUnique = pushUnique;
 exports.sum = sum;
 exports.unique = unique;
+exports.unshiftUnique = unshiftUnique;
 exports.areEqual = areEqual;
 exports.clone = clone;
 exports.shuffle = shuffle;
@@ -79,10 +83,10 @@ exports.flatten = flatten;
 exports.get = get;
 exports.map = map;
 exports.merge = merge;
-exports.Obj = obj;
 exports.only = only;
 exports.set = set;
 exports.sort = sort;
+exports.unset = unset;
 exports.Random = random;
 exports.capitalize = capitalize;
 exports.extension = extension;

package/cjs/mixed/shuffle/shuffle.d.ts

@@ -1,5 +1,5 @@
 /**
- * Shuffle array items
+ * Shuffle value either it is a string or an array
  */
-export default function shuffle(array: any[] | string): any[] | string;
+export default function shuffle(value: any[] | string): any[] | string;
 //# sourceMappingURL=shuffle.d.ts.map

package/cjs/mixed/shuffle/shuffle.js

@@ -1,14 +1,16 @@
 "use strict";
 
 /**
- * Shuffle array items
+ * Shuffle value either it is a string or an array
  */
-function shuffle(array) {
-  if (typeof array === "string") {
-    return shuffle(array.split("")).join("");
+function shuffle(value) {
+  if (!value || (!Array.isArray(value) && typeof value !== "string"))
+    return value;
+  if (typeof value === "string") {
+    return shuffle(value.split("")).join("");
   }
-  if (!Array.isArray(array)) return array;
-  return array.sort(() => Math.random() - 0.5);
+  if (!Array.isArray(value)) return value;
+  return value.sort(() => Math.random() - 0.5);
 }
 
 module.exports = shuffle;

package/cjs/string/capitalize.js

@@ -8,6 +8,7 @@ var ucfirst = require("./ucfirst.js");
  * @return string
  */
 function capitalize(string) {
+  if (!string) return "";
   return string
     .split(" ")
     .map(word => ucfirst(word))

package/cjs/string/extension.js

@@ -4,6 +4,7 @@
  * Get the extension of the file name
  */
 function extension(string) {
+  if (!string) return "";
   const regex = /(?:\.([^.]+))?$/,
     extension = regex.exec(string);
   return extension ? extension[1] : "";

package/cjs/string/ltrim.js

@@ -9,6 +9,7 @@ var escapeRegex = require("../utils/escapeRegex.js");
  * @return string
  */
 function ltrim(string, needle = " ") {
+  if (!string) return "";
   const pattern = "^" + escapeRegex(needle) + "+",
     regex = new RegExp(pattern, "g");
   return string.replace(regex, "");

package/cjs/string/readMoreChars.js

@@ -5,6 +5,7 @@
  *
  */
 function readMoreChars(string, length, readMoreDots = "...") {
+  if (!string) return "";
   if (string.length <= length) return string;
   return string.substring(0, length) + readMoreDots;
 }

package/cjs/string/readMoreWords.js

@@ -5,6 +5,7 @@
  *
  */
 function readMoreWords(string, length, readMoreDots = "...") {
+  if (!string) return "";
   const wordsList = string.split(" ");
   const words = wordsList.slice(0, length);
   return (

package/cjs/string/removeFirst.js

@@ -9,6 +9,7 @@ var replaceFirst = require("./replaceFirst.js");
  * @return string
  */
 function removeFirst(string, needle) {
+  if (!string) return "";
   return replaceFirst(string, needle, "");
 }
 

package/cjs/string/removeLast.js

@@ -9,6 +9,7 @@ var replaceLast = require("./replaceLast.js");
  * @return string
  */
 function removeLast(string, needle) {
+  if (!string) return "";
   return replaceLast(string, needle, "");
 }
 

package/cjs/string/repeatsOf.js

@@ -7,6 +7,7 @@
  * @return int
  */
 function repeatsOf(string, needle, caseSensitive = true) {
+  if (!string) return 0;
   let flags = "g";
   if (caseSensitive === false) {
     flags += "i";

package/cjs/string/replaceAll.js

@@ -10,6 +10,7 @@ var escapeRegex = require("../utils/escapeRegex.js");
  * @returns string
  */
 function replaceAll(string, searchText, replacement) {
+  if (!string) return "";
   return string.replace(new RegExp(escapeRegex(searchText), "g"), replacement);
 }
 

package/cjs/string/replaceFirst.js

@@ -10,6 +10,7 @@ var escapeRegex = require("../utils/escapeRegex.js");
  * @return string
  */
 function replaceFirst(string, needle, replacement) {
+  if (!string) return "";
   return string.replace(escapeRegex(needle), replacement);
 }
 

package/cjs/string/replaceLast.js

@@ -8,6 +8,7 @@
  * @return string
  */
 function replaceLast(string, needle, replacement) {
+  if (!string) return "";
   const lastIndex = string.lastIndexOf(needle);
   if (lastIndex < 0) {
     return string;

package/cjs/string/rtrim.js

@@ -9,6 +9,7 @@ var escapeRegex = require("../utils/escapeRegex.js");
  * @return string
  */
 function rtrim(string, needle = " ") {
+  if (!string) return "";
   const pattern = escapeRegex(needle) + "+$",
     regex = new RegExp(pattern, "g");
   return string.replace(regex, "");

package/cjs/string/startsWithArabic.d.ts

@@ -1,3 +1,3 @@
 export declare const ARABIC_PATTERN: RegExp;
-export default function startsWithArabic(text: string, trimmed?: boolean): boolean;
+export default function startsWithArabic(string: string, trimmed?: boolean): boolean;
 //# sourceMappingURL=startsWithArabic.d.ts.map

package/cjs/string/startsWithArabic.js

@@ -5,11 +5,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 var trim = require("./trim.js");
 
 const ARABIC_PATTERN = /[\u0600-\u06FF]/;
-function startsWithArabic(text, trimmed = true) {
+function startsWithArabic(string, trimmed = true) {
+  if (!string) return false;
   if (trimmed === true) {
-    text = trim(String(text));
+    string = trim(String(string));
   }
-  return text.charAt(0).match(ARABIC_PATTERN) !== null;
+  return string.charAt(0).match(ARABIC_PATTERN) !== null;
 }
 
 exports.ARABIC_PATTERN = ARABIC_PATTERN;

package/cjs/string/toCamelCase.js

@@ -3,6 +3,7 @@
 var capitalize = require("./capitalize.js");
 
 function toCamelCase(string, separator = "\\s+|-|/|_|\\.") {
+  if (!string) return "";
   const regex = new RegExp(separator + "|(?=[A-Z])", "g");
   return string
     .split(regex)

package/cjs/string/toKebabCase.js

@@ -6,6 +6,7 @@ var toSnakeCase = require("./toSnakeCase.js");
  * Convert current string to kebab case
  */
 function toKebabCase(string, lowerAll = true) {
+  if (!string) return "";
   return toSnakeCase(string, "-", lowerAll);
 }
 

package/cjs/string/toSnakeCase.js

@@ -7,6 +7,7 @@
  * @return string
  */
 function toSnakeCase(string, separator = "_", lowerAll = true) {
+  if (!string) return "";
   return string
     .replace(/(-|\/|\s|([A-Z]))+/g, function (_match, _v2, matchedUpperLetter) {
       if (!matchedUpperLetter) return separator;

package/cjs/string/toStudlyCase.js

@@ -11,6 +11,7 @@ var capitalize = require("./capitalize.js");
  * @see String.capitalize
  */
 function toStudlyCase(string, separator = "-|\\.|_|/|\\s") {
+  if (!string) return "";
   const regex = new RegExp(separator, "g");
   return string
     .split(regex)

package/cjs/string/trim.js

@@ -9,6 +9,7 @@ var escapeRegex = require("../utils/escapeRegex.js");
  * @return string
  */
 function trim(string, needle = " ") {
+  if (!string) return "";
   if (needle === " ") {
     return string.replace(/^\s+|\s+$/g, "");
   }

package/cjs/string/ucfirst.js

@@ -6,6 +6,7 @@
  * @return string
  */
 function ucfirst(string) {
+  if (!string) return "";
   return string.charAt(0).toUpperCase() + string.slice(1);
 }
 

package/esm/array/countBy.d.ts

@@ -1,5 +1,7 @@
 /**
  * Count the occurrences of values in an array for the given key
  */
-export default function countBy(array: any[], key: string): any;
+export default function countBy(array: any[], key: string): {
+    [key: string]: number;
+};
 //# sourceMappingURL=countBy.d.ts.map

package/esm/array/countBy.js

@@ -0,0 +1,21 @@
+import get from "../object/get.js";
+
+/**
+ * Count the occurrences of values in an array for the given key
+ */
+function countBy(array, key) {
+  if (!Array.isArray(array)) {
+    return {};
+  }
+  return array.reduce((result, item) => {
+    const value = get(item, key);
+    if (result[value]) {
+      result[value]++;
+    } else {
+      result[value] = 1;
+    }
+    return result;
+  }, {});
+}
+
+export { countBy as default };

package/esm/array/pushUnique.d.ts

@@ -2,5 +2,5 @@
  * Push once one or more values to the array if and
  * only if the value doesn't exists in the array
  */
-export default function pushUnique<T>(array: T[], ...items: T[]): T[];
+export default function pushUnique<T = any>(array: T[], ...items: T[]): T[];
 //# sourceMappingURL=pushUnique.d.ts.map

package/esm/array/unshiftUnique.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Prepend once one or more values to the array if and
+ * only if the value doesn't exists in the array
+ */
+export default function unshiftUnique<T = any>(array: T[], ...items: T[]): T[];
+//# sourceMappingURL=unshiftUnique.d.ts.map

package/esm/array/unshiftUnique.js

@@ -0,0 +1,14 @@
+/**
+ * Prepend once one or more values to the array if and
+ * only if the value doesn't exists in the array
+ */
+function unshiftUnique(array, ...items) {
+  items.forEach(item => {
+    if (!array.includes(item)) {
+      array.unshift(item);
+    }
+  });
+  return array;
+}
+
+export { unshiftUnique as default };

package/esm/index.d.ts

@@ -1,6 +1,7 @@
 export { default as average, default as avg } from "./array/average";
 export { default as chunk } from "./array/chunk";
 export { default as count } from "./array/count";
+export { default as countBy } from "./array/countBy";
 export { default as even } from "./array/even";
 export { default as evenIndexes } from "./array/evenIndexes";
 export { default as groupBy } from "./array/groupBy";
@@ -13,6 +14,7 @@ export { default as pluck } from "./array/pluck";
 export { default as pushUnique } from "./array/pushUnique";
 export { default as sum } from "./array/sum";
 export { default as unique } from "./array/unique";
+export { default as unshiftUnique } from "./array/unshiftUnique";
 export { default as areEqual } from "./mixed/areEqual/areEqual";
 export { default as clone } from "./mixed/clone/clone";
 export { default as shuffle } from "./mixed/shuffle/shuffle";
@@ -22,10 +24,10 @@ export { default as flatten } from "./object/flatten";
 export { default as get } from "./object/get";
 export { default as map } from "./object/map";
 export { default as merge } from "./object/merge";
-export { default as Obj } from "./object/obj";
 export { default as only } from "./object/only";
 export { default as set } from "./object/set";
 export { default as sort } from "./object/sort";
+export { default as unset } from "./object/unset";
 export { default as Random } from "./Random/random";
 export { default as capitalize } from "./string/capitalize";
 export { default as extension } from "./string/extension";

package/esm/index.js

@@ -1,6 +1,7 @@
 export { default as average, default as avg } from "./array/average.js";
 export { default as chunk } from "./array/chunk.js";
 export { default as count } from "./array/count.js";
+export { default as countBy } from "./array/countBy.js";
 export { default as even } from "./array/even.js";
 export { default as evenIndexes } from "./array/evenIndexes.js";
 export { default as groupBy } from "./array/groupBy.js";
@@ -13,6 +14,7 @@ export { default as pluck } from "./array/pluck.js";
 export { default as pushUnique } from "./array/pushUnique.js";
 export { default as sum } from "./array/sum.js";
 export { default as unique } from "./array/unique.js";
+export { default as unshiftUnique } from "./array/unshiftUnique.js";
 export { default as areEqual } from "./mixed/areEqual/areEqual.js";
 export { default as clone } from "./mixed/clone/clone.js";
 export { default as shuffle } from "./mixed/shuffle/shuffle.js";
@@ -22,10 +24,10 @@ export { default as flatten } from "./object/flatten.js";
 export { default as get } from "./object/get.js";
 export { default as map } from "./object/map.js";
 export { default as merge } from "./object/merge.js";
-export { default as Obj } from "./object/obj.js";
 export { default as only } from "./object/only.js";
 export { default as set } from "./object/set.js";
 export { default as sort } from "./object/sort.js";
+export { default as unset } from "./object/unset.js";
 export { default as Random } from "./Random/random.js";
 export { default as capitalize } from "./string/capitalize.js";
 export { default as extension } from "./string/extension.js";

package/esm/mixed/shuffle/shuffle.d.ts

@@ -1,5 +1,5 @@
 /**
- * Shuffle array items
+ * Shuffle value either it is a string or an array
  */
-export default function shuffle(array: any[] | string): any[] | string;
+export default function shuffle(value: any[] | string): any[] | string;
 //# sourceMappingURL=shuffle.d.ts.map

package/esm/mixed/shuffle/shuffle.js

@@ -1,12 +1,14 @@
 /**
- * Shuffle array items
+ * Shuffle value either it is a string or an array
  */
-function shuffle(array) {
-  if (typeof array === "string") {
-    return shuffle(array.split("")).join("");
+function shuffle(value) {
+  if (!value || (!Array.isArray(value) && typeof value !== "string"))
+    return value;
+  if (typeof value === "string") {
+    return shuffle(value.split("")).join("");
   }
-  if (!Array.isArray(array)) return array;
-  return array.sort(() => Math.random() - 0.5);
+  if (!Array.isArray(value)) return value;
+  return value.sort(() => Math.random() - 0.5);
 }
 
 export { shuffle as default };

package/esm/string/capitalize.js

@@ -6,6 +6,7 @@ import ucfirst from "./ucfirst.js";
  * @return string
  */
 function capitalize(string) {
+  if (!string) return "";
   return string
     .split(" ")
     .map(word => ucfirst(word))

package/esm/string/extension.js

@@ -2,6 +2,7 @@
  * Get the extension of the file name
  */
 function extension(string) {
+  if (!string) return "";
   const regex = /(?:\.([^.]+))?$/,
     extension = regex.exec(string);
   return extension ? extension[1] : "";

package/esm/string/ltrim.js

@@ -7,6 +7,7 @@ import escapeRegex from "../utils/escapeRegex.js";
  * @return string
  */
 function ltrim(string, needle = " ") {
+  if (!string) return "";
   const pattern = "^" + escapeRegex(needle) + "+",
     regex = new RegExp(pattern, "g");
   return string.replace(regex, "");

package/esm/string/readMoreChars.js

@@ -3,6 +3,7 @@
  *
  */
 function readMoreChars(string, length, readMoreDots = "...") {
+  if (!string) return "";
   if (string.length <= length) return string;
   return string.substring(0, length) + readMoreDots;
 }

package/esm/string/readMoreWords.js

@@ -3,6 +3,7 @@
  *
  */
 function readMoreWords(string, length, readMoreDots = "...") {
+  if (!string) return "";
   const wordsList = string.split(" ");
   const words = wordsList.slice(0, length);
   return (

package/esm/string/removeFirst.js

@@ -7,6 +7,7 @@ import replaceFirst from "./replaceFirst.js";
  * @return string
  */
 function removeFirst(string, needle) {
+  if (!string) return "";
   return replaceFirst(string, needle, "");
 }
 

package/esm/string/removeLast.js

@@ -7,6 +7,7 @@ import replaceLast from "./replaceLast.js";
  * @return string
  */
 function removeLast(string, needle) {
+  if (!string) return "";
   return replaceLast(string, needle, "");
 }
 

package/esm/string/repeatsOf.js

@@ -5,6 +5,7 @@
  * @return int
  */
 function repeatsOf(string, needle, caseSensitive = true) {
+  if (!string) return 0;
   let flags = "g";
   if (caseSensitive === false) {
     flags += "i";

package/esm/string/replaceAll.js

@@ -8,6 +8,7 @@ import escapeRegex from "../utils/escapeRegex.js";
  * @returns string
  */
 function replaceAll(string, searchText, replacement) {
+  if (!string) return "";
   return string.replace(new RegExp(escapeRegex(searchText), "g"), replacement);
 }
 

package/esm/string/replaceFirst.js

@@ -8,6 +8,7 @@ import escapeRegex from "../utils/escapeRegex.js";
  * @return string
  */
 function replaceFirst(string, needle, replacement) {
+  if (!string) return "";
   return string.replace(escapeRegex(needle), replacement);
 }
 

package/esm/string/replaceLast.js

@@ -6,6 +6,7 @@
  * @return string
  */
 function replaceLast(string, needle, replacement) {
+  if (!string) return "";
   const lastIndex = string.lastIndexOf(needle);
   if (lastIndex < 0) {
     return string;

package/esm/string/rtrim.js

@@ -7,6 +7,7 @@ import escapeRegex from "../utils/escapeRegex.js";
  * @return string
  */
 function rtrim(string, needle = " ") {
+  if (!string) return "";
   const pattern = escapeRegex(needle) + "+$",
     regex = new RegExp(pattern, "g");
   return string.replace(regex, "");

package/esm/string/startsWithArabic.d.ts

@@ -1,3 +1,3 @@
 export declare const ARABIC_PATTERN: RegExp;
-export default function startsWithArabic(text: string, trimmed?: boolean): boolean;
+export default function startsWithArabic(string: string, trimmed?: boolean): boolean;
 //# sourceMappingURL=startsWithArabic.d.ts.map