feat(util): self docs to type converters + add more options for strToBool

Author: wdhdev

src/modules/util/boolToNum.js

@@ -1,3 +1,9 @@
+/**
+ * @function `boolToNum` - Convert a boolean to a number.
+ * @param { Boolean } boolean - *Required* The boolean to be converted.
+ * @returns { Number } - The output of the conversion.
+ */
+
 function boolToNum(boolean) {
     if (typeof boolean !== "boolean") throw new Error("No boolean provided");
 

src/modules/util/boolToStr.js

@@ -1,3 +1,9 @@
+/**
+ * @function `boolToStr` - Convert a boolean to a string.
+ * @param { Boolean } boolean - *Required* The boolean to be converted.
+ * @returns { String } - The output of the conversion.
+ */
+
 function boolToStr(boolean) {
     if (typeof boolean !== "boolean") throw new Error("No boolean provided");
 

src/modules/util/numToBool.js

@@ -1,3 +1,9 @@
+/**
+ * @function `numToBool` - Convert a number to a boolean.
+ * @param { Number } number - *Required* The number to be converted.
+ * @returns { Boolean } - The output of the conversion.
+ */
+
 function numToBool(number) {
     if (typeof number !== "number") throw new Error("No number provided");
     if (number !== 1 && number !== 0)

src/modules/util/numToStr.js

@@ -1,3 +1,9 @@
+/**
+ * @function `numToStr` - Convert a number to a string.
+ * @param { Number } number - *Required* The number to be converted.
+ * @returns { String } - The output of the conversion.
+ */
+
 function numToStr(number) {
     if (typeof number !== "number") throw new Error("No number provided");
 

src/modules/util/strToBool.js

@@ -1,14 +1,20 @@
+/**
+ * @function `strToBool` - Convert a string to a boolean.
+ * @param { String } number - *Required* The string to be converted.
+ * @returns { Boolean } - The output of the conversion.
+ */
+
 function strToBool(string) {
     if (!string || typeof string !== "string")
         throw new Error("No string provided");
 
-    if (string !== "true" && string !== "false")
+    if (string !== "true" && string !== "false" && string !== "1" && string !== "0")
         throw new Error("No valid string provided");
 
     let res;
 
-    if (string === "true") res = Boolean(true);
-    if (string === "false") res = Boolean(false);
+    if (string === "true" || string === "1") res = Boolean(true);
+    if (string === "false" || string === "0") res = Boolean(false);
 
     return res;
 }

src/modules/util/strToNum.js

@@ -1,3 +1,9 @@
+/**
+ * @function `strToNum` - Convert a string to a number.
+ * @param { String } number - *Required* The string to be converted.
+ * @returns { Number } - The output of the conversion.
+ */
+
 function strToNum(string) {
     if (!string || typeof string !== "string")
         throw new Error("No string provided");