itee-validators 5.5.1 → 6.0.0

package/builds/itee-validators.cjs.js

@@ -1,8 +1,8 @@
 /**
- * ┳      ┓┏  ┓• ┓            ┏━ ┏━ ┓      ┏┓            ┏┳ 
- * ┃╋┏┓┏┓ ┃┃┏┓┃┓┏┫┏┓╋┏┓┏┓┏  ┓┏┗┓ ┗┓ ┃  ━━  ┃ ┏┓┏┳┓┏┳┓┏┓┏┓ ┃┏
- * ┻┗┗ ┗ •┗┛┗┻┗┗┗┻┗┻┗┗┛┛ ┛  ┗┛┗┛•┗┛•┻      ┗┛┗┛┛┗┗┛┗┗┗┛┛┗┗┛┛
- *                                                          
+ * ┳      ┓┏  ┓• ┓            ┏┓ ┏┓ ┏┓      ┏┓            ┏┳ 
+ * ┃╋┏┓┏┓ ┃┃┏┓┃┓┏┫┏┓╋┏┓┏┓┏  ┓┏┣┓ ┃┫ ┃┫  ━━  ┃ ┏┓┏┳┓┏┳┓┏┓┏┓ ┃┏
+ * ┻┗┗ ┗ •┗┛┗┻┗┗┗┻┗┻┗┗┛┛ ┛  ┗┛┗┛•┗┛•┗┛      ┗┛┗┛┛┗┗┛┗┗┗┛┛┗┗┛┛
+ *                                                           
  * @desc    A library of validation functions use in various Itee projects
  * @author  [Tristan Valcke]{@link https://github.com/Itee}
  * @license [BSD-3-Clause]{@link https://opensource.org/licenses/BSD-3-Clause}
@@ -10,9 +10,7 @@
  */
 'use strict';
 
-Object.defineProperty(exports, '__esModule', { value: true });
-
-var fs = require('fs');
+var node_fs = require('node:fs');
 
 /**
  * @author [Tristan Valcke]{@link https://github.com/Itee}
@@ -70,6 +68,7 @@ function isNotArray( data ) {
  *
  */
 
+
 /**
  * Check if given data is an empty array
  *
@@ -116,6 +115,7 @@ function isNotEmptyArray( data ) {
  *
  */
 
+
 /**
  * Check if given data is an array of array
  *
@@ -214,6 +214,7 @@ function isNotBoolean( data ) {
  *
  */
 
+
 /**
  * Check if given data is not an empty array where all values are boolean
  *
@@ -312,6 +313,7 @@ function isNotFunction( data ) {
  *
  */
 
+
 /**
  * Check if given data is not an empty array where all values are functions
  *
@@ -372,6 +374,7 @@ function isNotArrayOfFunction( data ) {
  *
  */
 
+
 /**
  * Check if given data is an array with multiples values
  *
@@ -443,6 +446,7 @@ function isNotNull( data ) {
  * } *
  */
 
+
 /**
  * Check if given data is not an empty array where all values are null
  *
@@ -651,6 +655,7 @@ function isZeroNegative( data ) {
  *
  */
 
+
 /**
  * Check if given data is a number
  *
@@ -754,6 +759,7 @@ function isNaN( data ) {
  *
  */
 
+
 /**
  * Check if given data is not an empty array where all values are numbers
  *
@@ -814,6 +820,7 @@ function isNotArrayOfNumber( data ) {
  *
  */
 
+
 /**
  * Check if given data is an object
  *
@@ -855,6 +862,7 @@ function isNotObject( data ) {
  *
  */
 
+
 /**
  * Check if given data is an array where all values are of object type
  *
@@ -915,6 +923,7 @@ function isNotArrayOfObject( data ) {
  *
  */
 
+
 /**
  * Check if given data is an array with a single value
  *
@@ -989,6 +998,7 @@ function isNotString( data ) {
  *
  */
 
+
 /**
  * Check if given data is not an empty array where all values are string
  *
@@ -1087,6 +1097,7 @@ function isNotUndefined( data ) {
  *
  */
 
+
 /**
  * Check if given data is not an empty array where all values are undefined
  *
@@ -1147,6 +1158,7 @@ function isNotArrayOfUndefined( data ) {
  *
  */
 
+
 /**
  * Check if given data is a boolean with value to true
  *
@@ -1303,6 +1315,7 @@ function isMinSafeInteger( data ) {
  *
  */
 
+
 /**
  * Check if given data is an empty object
  *
@@ -1356,6 +1369,7 @@ function isNotEmptyObject( data ) {
  *
  */
 
+
 /**
  * Check if given data is an empty string
  *
@@ -1402,6 +1416,7 @@ function isNotEmptyString( data ) {
  *
  */
 
+
 /**
  * Check if the given data is a blank string
  *
@@ -1484,6 +1499,7 @@ function isNotSymbol( data ) {
  *
  */
 
+
 /**
  * Check emptiness of given data
  *
@@ -1639,6 +1655,7 @@ function isNotEmpty( data ) {
  *
  */
 
+
 class Validator {
 
     constructor() {
@@ -2310,6 +2327,7 @@ const ABSOLUTE_ZERO_FAHRENHEIT = -459.67;
  *
  */
 
+
 /**
  *
  * @param data {*}
@@ -2346,6 +2364,7 @@ function isNotCelsius( data ) {
  *
  */
 
+
 /**
  *
  * @param data {*}
@@ -2382,6 +2401,7 @@ function isNotFahrenheit( data ) {
  *
  */
 
+
 /**
  *
  * @param data {*}
@@ -2418,6 +2438,7 @@ function isNotKelvin( data ) {
  *
  */
 
+
 /**
  *
  * @param data {*}
@@ -2457,6 +2478,7 @@ function isNotTemperature( data ) {
  *
  */
 
+
 /**
  * Check if given path is a block device path
  *
@@ -2465,10 +2487,11 @@ function isNotTemperature( data ) {
  */
 function isBlockDevicePath( path ) {
     if ( isNotString( path ) && !( path instanceof Buffer ) && !( path instanceof URL ) ) {
-        throw new TypeError( 'Invalid path type! Expect string, buffer or url.' )
+        return false
+        // throw new TypeError( 'Invalid path type! Expect string, buffer or url.' )
     }
 
-    const stat = fs.statSync( path, { throwIfNoEntry: false } );
+    const stat = node_fs.statSync( path, { throwIfNoEntry: false } );
     return isDefined( stat ) && stat.isBlockDevice()
 }
 
@@ -2503,6 +2526,7 @@ function isNotBlockDevicePath( path ) {
  *
  */
 
+
 /**
  * Check if given data is a valid file path
  *
@@ -2510,7 +2534,7 @@ function isNotBlockDevicePath( path ) {
  * @returns {boolean} true if data is a valid path, false otherwise
  */
 function isValidPath( data ) {
-    return fs.existsSync( data )
+    return node_fs.existsSync( data )
 }
 
 /**
@@ -2541,6 +2565,7 @@ function isInvalidPath( data ) {
  *
  */
 
+
 /**
  * Check if given data is a valid block device path
  *
@@ -2582,6 +2607,7 @@ function isInvalidBlockDevicePath( data ) {
  *
  */
 
+
 /**
  * Check if given path is a character device path
  *
@@ -2590,10 +2616,11 @@ function isInvalidBlockDevicePath( data ) {
  */
 function isCharacterDevicePath( path ) {
     if ( isNotString( path ) && !( path instanceof Buffer ) && !( path instanceof URL ) ) {
-        throw new TypeError( 'Invalid path type! Expect string, buffer or url.' )
+        return false
+        // throw new TypeError( 'Invalid path type! Expect string, buffer or url.' )
     }
 
-    const stat = fs.statSync( path, { throwIfNoEntry: false } );
+    const stat = node_fs.statSync( path, { throwIfNoEntry: false } );
     return isDefined( stat ) && stat.isCharacterDevice()
 }
 
@@ -2625,6 +2652,7 @@ function isNotCharacterDevicePath( path ) {
  *
  */
 
+
 /**
  * Check if given data is a valid character device path
  *
@@ -2666,6 +2694,7 @@ function isInvalidCharacterDevicePath( data ) {
  *
  */
 
+
 /**
  * Check if given path is a directory path
  *
@@ -2674,10 +2703,11 @@ function isInvalidCharacterDevicePath( data ) {
  */
 function isDirectoryPath( path ) {
     if ( isNotString( path ) && !( path instanceof Buffer ) && !( path instanceof URL ) ) {
-        throw new TypeError( 'Invalid path type! Expect string, buffer or url.' )
+        return false
+        // throw new TypeError( 'Invalid path type! Expect string, buffer or url.' )
     }
 
-    const stat = fs.statSync( path, { throwIfNoEntry: false } );
+    const stat = node_fs.statSync( path, { throwIfNoEntry: false } );
     return isDefined( stat ) && stat.isDirectory()
 }
 
@@ -2712,6 +2742,7 @@ function isNotDirectoryPath( path ) {
  *
  */
 
+
 /**
  * Check if given directory path is an empty directory
  *
@@ -2719,7 +2750,7 @@ function isNotDirectoryPath( path ) {
  * @returns {boolean} true if directory is empty, false otherwise
  */
 function isEmptyDirectory( directoryPath ) {
-    return isDirectoryPath( directoryPath ) && ( fs.readdirSync( directoryPath ).length === 0 )
+    return isDirectoryPath( directoryPath ) && ( node_fs.readdirSync( directoryPath ).length === 0 )
 }
 
 /**
@@ -2750,6 +2781,7 @@ function isNotEmptyDirectory( directoryPath ) {
  *
  */
 
+
 /**
  * Check if given data is a valid directory path
  *
@@ -2791,6 +2823,7 @@ function isInvalidDirectoryPath( data ) {
  *
  */
 
+
 /**
  * Check if given path is a fifo path
  *
@@ -2799,10 +2832,11 @@ function isInvalidDirectoryPath( data ) {
  */
 function isFIFOPath( path ) {
     if ( isNotString( path ) && !( path instanceof Buffer ) && !( path instanceof URL ) ) {
-        throw new TypeError( 'Invalid path type! Expect string, buffer or url.' )
+        return false
+        // throw new TypeError( 'Invalid path type! Expect string, buffer or url.' )
     }
 
-    const stat = fs.statSync( path, { throwIfNoEntry: false } );
+    const stat = node_fs.statSync( path, { throwIfNoEntry: false } );
     return isDefined( stat ) && stat.isFIFO()
 }
 
@@ -2837,6 +2871,7 @@ function isNotFIFOPath( path ) {
  *
  */
 
+
 /**
  * Check if given data is a valid fifo path
  *
@@ -2878,6 +2913,7 @@ function isInvalidFIFOPath( data ) {
  *
  */
 
+
 /**
  * Check if given path is a file path
  *
@@ -2886,10 +2922,11 @@ function isInvalidFIFOPath( data ) {
  */
 function isFilePath( path ) {
     if ( isNotString( path ) && !( path instanceof Buffer ) && !( path instanceof URL ) ) {
-        throw new TypeError( 'Invalid path type! Expect string, buffer or url.' )
+        return false
+        // throw new TypeError( 'Invalid path type! Expect string, buffer or url.' )
     }
 
-    const stat = fs.statSync( path, { throwIfNoEntry: false } );
+    const stat = node_fs.statSync( path, { throwIfNoEntry: false } );
     return isDefined( stat ) && stat.isFile()
 }
 
@@ -2924,6 +2961,7 @@ function isNotFilePath( path ) {
  *
  */
 
+
 /**
  * Check if given file path is an empty file more or less a threshold in bytes.
  *
@@ -2933,10 +2971,11 @@ function isNotFilePath( path ) {
  */
 function isEmptyFile( filePath, threshold = 0 ) {
     if ( isNotString( filePath ) && !( filePath instanceof Buffer ) && !( filePath instanceof URL ) ) {
-        throw new TypeError( 'Invalid path type! Expect string, buffer or url.' )
+        return false
+        // throw new TypeError( 'Invalid path type! Expect string, buffer or url.' )
     }
 
-    return isFilePath( filePath ) && ( fs.statSync( filePath ).size <= threshold )
+    return isFilePath( filePath ) && ( node_fs.statSync( filePath ).size <= threshold )
 }
 
 /**
@@ -2968,6 +3007,7 @@ function isNotEmptyFile( filePath, threshold = 0 ) {
  *
  */
 
+
 /**
  * Check if given data is a valid file path
  *
@@ -3009,6 +3049,7 @@ function isInvalidFilePath( data ) {
  *
  */
 
+
 /**
  * Check if given path is a socket path
  *
@@ -3017,10 +3058,11 @@ function isInvalidFilePath( data ) {
  */
 function isSocketPath( path ) {
     if ( isNotString( path ) && !( path instanceof Buffer ) && !( path instanceof URL ) ) {
-        throw new TypeError( 'Invalid path type! Expect string, buffer or url.' )
+        return false
+        // throw new TypeError( 'Invalid path type! Expect string, buffer or url.' )
     }
 
-    const stat = fs.statSync( path, { throwIfNoEntry: false } );
+    const stat = node_fs.statSync( path, { throwIfNoEntry: false } );
     return isDefined( stat ) && stat.isSocket()
 }
 
@@ -3052,6 +3094,7 @@ function isNotSocketPath( path ) {
  *
  */
 
+
 /**
  * Check if given data is a valid socket path
  *
@@ -3093,6 +3136,7 @@ function isInvalidSocketPath( data ) {
  *
  */
 
+
 /**
  * Check if given path is a symbolic link path
  *
@@ -3101,10 +3145,11 @@ function isInvalidSocketPath( data ) {
  */
 function isSymbolicLinkPath( path ) {
     if ( isNotString( path ) && !( path instanceof Buffer ) && !( path instanceof URL ) ) {
-        throw new TypeError( 'Invalid path type! Expect string, buffer or url.' )
+        return false
+        // throw new TypeError( 'Invalid path type! Expect string, buffer or url.' )
     }
 
-    const stat = fs.statSync( path, { throwIfNoEntry: false } );
+    const stat = node_fs.statSync( path, { throwIfNoEntry: false } );
     return isDefined( stat ) && stat.isSymbolicLink()
 }
 
@@ -3136,6 +3181,7 @@ function isNotSymbolicLinkPath( path ) {
  *
  */
 
+
 /**
  * Check if given data is a valid symbolic link path
  *