@awesomeness-js/utils 1.2.9 → 1.2.10

package/index.js

@@ -1,122 +1,122 @@
-/**
- * This file is auto-generated by the build script.
- * It consolidates API functions for use in the application.
- * Do not edit manually.
- */
-import _build from './src/build.js';
-import _clean_array from './src/clean/array.js';
-import _clean_boolean from './src/clean/boolean.js';
-import _clean_buffer from './src/clean/buffer.js';
-import _clean_custom from './src/clean/custom.js';
-import _clean_integer from './src/clean/integer.js';
-import _clean_number from './src/clean/number.js';
-import _clean_object from './src/clean/object.js';
-import _clean_string from './src/clean/string.js';
-import _clean_timestamp from './src/clean/timestamp.js';
-import _clean_uuid from './src/clean/uuid.js';
-import _collectImports from './src/collectImports.js';
-import _combineFiles from './src/combineFiles.js';
-import _convertBytes from './src/convertBytes.js';
-import _decrypt from './src/decrypt.js';
-import _each from './src/each.js';
-import _eachAsync from './src/eachAsync.js';
-import _encrypt from './src/encrypt.js';
-import _getAllFiles from './src/getAllFiles.js';
-import _isUUID from './src/isUUID.js';
-import _md5 from './src/md5.js';
-import _password_check from './src/password/check.js';
-import _password_hash from './src/password/hash.js';
-import _random_array from './src/random/array.js';
-import _random_arrayValue from './src/random/arrayValue.js';
-import _random_boolean from './src/random/boolean.js';
-import _random_integer from './src/random/integer.js';
-import _random_number from './src/random/number.js';
-import _random_object from './src/random/object.js';
-import _random_string from './src/random/string.js';
-import _random_timestamp from './src/random/timestamp.js';
-import _random_uuid from './src/random/uuid.js';
-import _setLocalEnvs from './src/setLocalEnvs.js';
-import _shouldIgnore from './src/shouldIgnore.js';
-import _thingType from './src/thingType.js';
-import _toPennies from './src/toPennies.js';
-import _utils_buildExportsTree from './src/utils/buildExportsTree.js';
-import _utils_buildFileDataList from './src/utils/buildFileDataList.js';
-import _utils_clean from './src/utils/clean.js';
-import _utils_extractJSDocComment from './src/utils/extractJSDocComment.js';
-import _utils_generateFile from './src/utils/generateFile.js';
-import _utils_generateFlatExportLines from './src/utils/generateFlatExportLines.js';
-import _utils_generateImportStatements from './src/utils/generateImportStatements.js';
-import _utils_generateNamedExports from './src/utils/generateNamedExports.js';
-import _utils_generateNamespaceCode from './src/utils/generateNamespaceCode.js';
-import _utils_generateNamespaceExportLines from './src/utils/generateNamespaceExportLines.js';
-import _uuid from './src/uuid.js';
-import _validateSchema from './src/validateSchema.js';
-import _wait from './src/wait.js';
-
-export { _build as build };
-export { _collectImports as collectImports };
-export { _combineFiles as combineFiles };
-export { _convertBytes as convertBytes };
-export { _decrypt as decrypt };
-export { _each as each };
-export { _eachAsync as eachAsync };
-export { _encrypt as encrypt };
-export { _getAllFiles as getAllFiles };
-export { _isUUID as isUUID };
-export { _md5 as md5 };
-export { _setLocalEnvs as setLocalEnvs };
-export { _shouldIgnore as shouldIgnore };
-export { _thingType as thingType };
-export { _toPennies as toPennies };
-export { _uuid as uuid };
-export { _validateSchema as validateSchema };
-export { _wait as wait };
-
-export const clean = {
-	array: _clean_array,
-	boolean: _clean_boolean,
-	buffer: _clean_buffer,
-	custom: _clean_custom,
-	integer: _clean_integer,
-	number: _clean_number,
-	object: _clean_object,
-	string: _clean_string,
-	timestamp: _clean_timestamp,
-	uuid: _clean_uuid
-};
-
-export const password = {
-	check: _password_check,
-	hash: _password_hash
-};
-
-export const random = {
-	array: _random_array,
-	arrayValue: _random_arrayValue,
-	boolean: _random_boolean,
-	integer: _random_integer,
-	number: _random_number,
-	object: _random_object,
-	string: _random_string,
-	timestamp: _random_timestamp,
-	uuid: _random_uuid
-};
-
-export const utils = {
-	buildExportsTree: _utils_buildExportsTree,
-	buildFileDataList: _utils_buildFileDataList,
-	clean: _utils_clean,
-	extractJSDocComment: _utils_extractJSDocComment,
-	generateFile: _utils_generateFile,
-	generateFlatExportLines: _utils_generateFlatExportLines,
-	generateImportStatements: _utils_generateImportStatements,
-	generateNamedExports: _utils_generateNamedExports,
-	generateNamespaceCode: _utils_generateNamespaceCode,
-	generateNamespaceExportLines: _utils_generateNamespaceExportLines
-};
-
-
-export default {
+/**
+ * This file is auto-generated by the build script.
+ * It consolidates API functions for use in the application.
+ * Do not edit manually.
+ */
+import _build from './src/build.js';
+import _clean_array from './src/clean/array.js';
+import _clean_boolean from './src/clean/boolean.js';
+import _clean_buffer from './src/clean/buffer.js';
+import _clean_custom from './src/clean/custom.js';
+import _clean_integer from './src/clean/integer.js';
+import _clean_number from './src/clean/number.js';
+import _clean_object from './src/clean/object.js';
+import _clean_string from './src/clean/string.js';
+import _clean_timestamp from './src/clean/timestamp.js';
+import _clean_uuid from './src/clean/uuid.js';
+import _collectImports from './src/collectImports.js';
+import _combineFiles from './src/combineFiles.js';
+import _convertBytes from './src/convertBytes.js';
+import _decrypt from './src/decrypt.js';
+import _each from './src/each.js';
+import _eachAsync from './src/eachAsync.js';
+import _encrypt from './src/encrypt.js';
+import _getAllFiles from './src/getAllFiles.js';
+import _isUUID from './src/isUUID.js';
+import _md5 from './src/md5.js';
+import _password_check from './src/password/check.js';
+import _password_hash from './src/password/hash.js';
+import _random_array from './src/random/array.js';
+import _random_arrayValue from './src/random/arrayValue.js';
+import _random_boolean from './src/random/boolean.js';
+import _random_integer from './src/random/integer.js';
+import _random_number from './src/random/number.js';
+import _random_object from './src/random/object.js';
+import _random_string from './src/random/string.js';
+import _random_timestamp from './src/random/timestamp.js';
+import _random_uuid from './src/random/uuid.js';
+import _setLocalEnvs from './src/setLocalEnvs.js';
+import _shouldIgnore from './src/shouldIgnore.js';
+import _thingType from './src/thingType.js';
+import _toPennies from './src/toPennies.js';
+import _utils_buildExportsTree from './src/utils/buildExportsTree.js';
+import _utils_buildFileDataList from './src/utils/buildFileDataList.js';
+import _utils_clean from './src/utils/clean.js';
+import _utils_extractJSDocComment from './src/utils/extractJSDocComment.js';
+import _utils_generateFile from './src/utils/generateFile.js';
+import _utils_generateFlatExportLines from './src/utils/generateFlatExportLines.js';
+import _utils_generateImportStatements from './src/utils/generateImportStatements.js';
+import _utils_generateNamedExports from './src/utils/generateNamedExports.js';
+import _utils_generateNamespaceCode from './src/utils/generateNamespaceCode.js';
+import _utils_generateNamespaceExportLines from './src/utils/generateNamespaceExportLines.js';
+import _uuid from './src/uuid.js';
+import _validateSchema from './src/validateSchema.js';
+import _wait from './src/wait.js';
+
+export { _build as build };
+export { _collectImports as collectImports };
+export { _combineFiles as combineFiles };
+export { _convertBytes as convertBytes };
+export { _decrypt as decrypt };
+export { _each as each };
+export { _eachAsync as eachAsync };
+export { _encrypt as encrypt };
+export { _getAllFiles as getAllFiles };
+export { _isUUID as isUUID };
+export { _md5 as md5 };
+export { _setLocalEnvs as setLocalEnvs };
+export { _shouldIgnore as shouldIgnore };
+export { _thingType as thingType };
+export { _toPennies as toPennies };
+export { _uuid as uuid };
+export { _validateSchema as validateSchema };
+export { _wait as wait };
+
+export const clean = {
+	array: _clean_array,
+	boolean: _clean_boolean,
+	buffer: _clean_buffer,
+	custom: _clean_custom,
+	integer: _clean_integer,
+	number: _clean_number,
+	object: _clean_object,
+	string: _clean_string,
+	timestamp: _clean_timestamp,
+	uuid: _clean_uuid
+};
+
+export const password = {
+	check: _password_check,
+	hash: _password_hash
+};
+
+export const random = {
+	array: _random_array,
+	arrayValue: _random_arrayValue,
+	boolean: _random_boolean,
+	integer: _random_integer,
+	number: _random_number,
+	object: _random_object,
+	string: _random_string,
+	timestamp: _random_timestamp,
+	uuid: _random_uuid
+};
+
+export const utils = {
+	buildExportsTree: _utils_buildExportsTree,
+	buildFileDataList: _utils_buildFileDataList,
+	clean: _utils_clean,
+	extractJSDocComment: _utils_extractJSDocComment,
+	generateFile: _utils_generateFile,
+	generateFlatExportLines: _utils_generateFlatExportLines,
+	generateImportStatements: _utils_generateImportStatements,
+	generateNamedExports: _utils_generateNamedExports,
+	generateNamespaceCode: _utils_generateNamespaceCode,
+	generateNamespaceExportLines: _utils_generateNamespaceExportLines
+};
+
+
+export default {
 	/**
 	 * Builds a file from the specified source directory and writes it to the destination file.
 	 *
@@ -128,19 +128,19 @@ export default {
 	 * @param {boolean} [options.includeComments=true] - Whether to include comments in the generated file.
 	 * @param {boolean} [options.dts=false] - Whether to generate TypeScript declaration files.
 	 * @returns {Promise<boolean>} A promise that resolves to true when the build is complete.
-	 */
-	build: _build,
-	collectImports: _collectImports,
-	combineFiles: _combineFiles,
+	 */
+	build: _build,
+	collectImports: _collectImports,
+	combineFiles: _combineFiles,
 	/**
 	 * Converts a given number of bytes into a more readable string format with appropriate units.
 	 *
 	 * @param {number} bytes - The number of bytes to convert.
 	 * @param {number} [precision=2] - The number of decimal places to include in the result.
 	 * @returns {string} The converted bytes in a string format with appropriate units.
-	 */
-	convertBytes: _convertBytes,
-	decrypt: _decrypt,
+	 */
+	convertBytes: _convertBytes,
+	decrypt: _decrypt,
 	/**
 	 * Iterates over elements of an array or properties of an object, invoking a callback for each element/property.
 	 * The iteration stops if the callback returns `false`.
@@ -149,57 +149,57 @@ export default {
 	 * @param {Object|Array} objectOrArray - The object or array to iterate over.
 	 * @param {Function} callback - The function to invoke per iteration. It is invoked with two arguments: (value, key/index).
 	 * @returns {void}
-	 */
-	each: _each,
-	eachAsync: _eachAsync,
-	encrypt: _encrypt,
-	getAllFiles: _getAllFiles,
-	isUUID: _isUUID,
-	md5: _md5,
-	setLocalEnvs: _setLocalEnvs,
-	shouldIgnore: _shouldIgnore,
-	thingType: _thingType,
-	toPennies: _toPennies,
-	uuid: _uuid,
-	validateSchema: _validateSchema,
-	wait: _wait,
-	clean: {
-		array: _clean_array,
-		boolean: _clean_boolean,
-		buffer: _clean_buffer,
-		custom: _clean_custom,
-		integer: _clean_integer,
-		number: _clean_number,
-		object: _clean_object,
-		string: _clean_string,
-		timestamp: _clean_timestamp,
-		uuid: _clean_uuid,
-	},
-	password: {
-		check: _password_check,
-		hash: _password_hash,
-	},
-	random: {
-		array: _random_array,
-		arrayValue: _random_arrayValue,
-		boolean: _random_boolean,
-		integer: _random_integer,
-		number: _random_number,
-		object: _random_object,
-		string: _random_string,
-		timestamp: _random_timestamp,
-		uuid: _random_uuid,
-	},
-	utils: {
-		buildExportsTree: _utils_buildExportsTree,
-		buildFileDataList: _utils_buildFileDataList,
-		clean: _utils_clean,
-		extractJSDocComment: _utils_extractJSDocComment,
-		generateFile: _utils_generateFile,
-		generateFlatExportLines: _utils_generateFlatExportLines,
-		generateImportStatements: _utils_generateImportStatements,
-		generateNamedExports: _utils_generateNamedExports,
-		generateNamespaceCode: _utils_generateNamespaceCode,
-		generateNamespaceExportLines: _utils_generateNamespaceExportLines,
-	},
+	 */
+	each: _each,
+	eachAsync: _eachAsync,
+	encrypt: _encrypt,
+	getAllFiles: _getAllFiles,
+	isUUID: _isUUID,
+	md5: _md5,
+	setLocalEnvs: _setLocalEnvs,
+	shouldIgnore: _shouldIgnore,
+	thingType: _thingType,
+	toPennies: _toPennies,
+	uuid: _uuid,
+	validateSchema: _validateSchema,
+	wait: _wait,
+	clean: {
+		array: _clean_array,
+		boolean: _clean_boolean,
+		buffer: _clean_buffer,
+		custom: _clean_custom,
+		integer: _clean_integer,
+		number: _clean_number,
+		object: _clean_object,
+		string: _clean_string,
+		timestamp: _clean_timestamp,
+		uuid: _clean_uuid,
+	},
+	password: {
+		check: _password_check,
+		hash: _password_hash,
+	},
+	random: {
+		array: _random_array,
+		arrayValue: _random_arrayValue,
+		boolean: _random_boolean,
+		integer: _random_integer,
+		number: _random_number,
+		object: _random_object,
+		string: _random_string,
+		timestamp: _random_timestamp,
+		uuid: _random_uuid,
+	},
+	utils: {
+		buildExportsTree: _utils_buildExportsTree,
+		buildFileDataList: _utils_buildFileDataList,
+		clean: _utils_clean,
+		extractJSDocComment: _utils_extractJSDocComment,
+		generateFile: _utils_generateFile,
+		generateFlatExportLines: _utils_generateFlatExportLines,
+		generateImportStatements: _utils_generateImportStatements,
+		generateNamedExports: _utils_generateNamedExports,
+		generateNamespaceCode: _utils_generateNamespaceCode,
+		generateNamespaceExportLines: _utils_generateNamespaceExportLines,
+	},
 };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@awesomeness-js/utils",
-    "version": "1.2.9",
+    "version": "1.2.10",
     "description": "Awesomeness - Utils",
     "repository": {
         "type": "git",

package/src/clean/buffer.js

@@ -6,56 +6,75 @@ export default function cleanBuffer(fileObj, {
 } = {}) {
 
 	try {
+
 		if (
 			!fileObj ||
 			typeof fileObj !== 'object' ||
 			!(fileObj.buffer instanceof Buffer)
 		) {
+
 			throw {
 				message: 'Invalid buffer object (expected Busboy fileObj)',
 				value: fileObj
 			};
+		
 		}
 
-		const { buffer, filename, mimeType, totalSize } = fileObj;
+		const {
+			buffer, 
+			filename, 
+			mimeType, 
+			totalSize 
+		} = fileObj;
+        
 		const size = totalSize ?? buffer.length;
 
 		// basic fields check
 		if (typeof size !== 'number' || !mimeType) {
+
 			throw {
 				message: 'Missing required fields (mimeType, size)',
 				value: fileObj
 			};
+		
 		}
 
 		// type validation
 		if (Array.isArray(validTypes) && validTypes.length > 0) {
-			const isValidType = validTypes.some(t =>
+
+			const isValidType = validTypes.some((t) =>
 				mimeType === t || (filename && filename.endsWith(t))
 			);
 
 			if (!isValidType) {
+
 				throw {
 					message: `Invalid buffer type: ${mimeType}`,
 					allowed: validTypes,
 					value: filename || null
 				};
+			
 			}
+		
 		}
 
 		// size validation
 		if (minSize !== false && size < minSize) {
+
 			throw {
 				message: `Buffer smaller than minimum size (${minSize} bytes)`,
 				value: size
 			};
+		
 		}
 
 		if (maxSize !== false && size > maxSize) {
+
 			throw {
 				message: `Buffer larger than maximum size (${maxSize} bytes)`,
 				value: size
 			};
+		
 		}
 
 		// normalized safe object
@@ -68,7 +87,11 @@ export default function cleanBuffer(fileObj, {
 		};
 
 	} catch (e) {
+
 		if (required) throw e;
+		
 		return null;
+	
 	}
+
 }

package/src/utils/clean.js

@@ -9,6 +9,7 @@ import cleanString from '../clean/string.js';
 import cleanTimestamp from '../clean/timestamp.js';
 import cleanUUID from '../clean/uuid.js';
 import cleanCustom from '../clean/custom.js';
+import cleanBuffer from '../clean/buffer.js';
 
 const knownTypesToClean = [
 	'array',
@@ -146,6 +147,12 @@ function cleanArray(arr, schema = {}, {
 
 				}
 
+				if(supposedToBeType === 'buffer'){
+	
+					cleanedItem = cleanBuffer(item, schema.items);
+
+				}
+
 				if(cleanedItem === null){
 
 					if(schema.required === true){
@@ -388,6 +395,21 @@ function cleanObject(obj, schema, {
 		
 		}
 
+
+		if(supposedToBeType === 'custom'){
+
+			cleanedValue = cleanCustom(value, schema.properties[key]);
+
+		}
+        
+
+		if(supposedToBeType === 'buffer'){
+
+			cleanedValue = cleanBuffer(value, schema.properties[key]);
+
+		}
+
+
 		cleanObj[key] = cleanedValue;
 
 	});

package/types/clean/array.d.ts

@@ -1,6 +1,6 @@
-declare const _default: (arr: any, schema?: {}, { testMode, allOrNothing, path }?: {
-    testMode?: boolean;
-    allOrNothing?: boolean;
-    path?: string;
-}) => any[];
-export default _default;
+declare const _default: (arr: any, schema?: {}, { testMode, allOrNothing, path }?: {
+    testMode?: boolean;
+    allOrNothing?: boolean;
+    path?: string;
+}) => any[];
+export default _default;

package/types/clean/buffer.d.ts

@@ -1,12 +1,12 @@
-export default function cleanBuffer(fileObj: any, { required, validTypes, minSize, maxSize, }?: {
-    required?: boolean;
-    validTypes?: any[];
-    minSize?: boolean;
-    maxSize?: boolean;
-}): {
-    name: any;
-    type: any;
-    size: number;
-    encoding: any;
-    createdAt: string;
-};
+export default function cleanBuffer(fileObj: any, { required, validTypes, minSize, maxSize, }?: {
+    required?: boolean;
+    validTypes?: any[];
+    minSize?: boolean;
+    maxSize?: boolean;
+}): {
+    name: any;
+    type: any;
+    size: number;
+    encoding: any;
+    createdAt: string;
+};

package/types/clean/custom.d.ts

@@ -1,4 +1,4 @@
-export default function cleanCustom(value: any, { required, validate, }?: {
-    required?: boolean;
-    validate?: any;
-}): any;
+export default function cleanCustom(value: any, { required, validate, }?: {
+    required?: boolean;
+    validate?: any;
+}): any;

package/types/clean/object.d.ts

@@ -1,6 +1,6 @@
-declare const _default: (obj: any, schema: any, { testMode, allOrNothing, path }?: {
-    testMode?: boolean;
-    allOrNothing?: boolean;
-    path?: string;
-}) => {};
-export default _default;
+declare const _default: (obj: any, schema: any, { testMode, allOrNothing, path }?: {
+    testMode?: boolean;
+    allOrNothing?: boolean;
+    path?: string;
+}) => {};
+export default _default;

package/types/clean/string.d.ts

@@ -1,10 +1,10 @@
-export default function cleanString(x: any, { required, minLength, maxLength, allowHtml, allowScripts, validValues, format, pattern }?: {
-    required?: boolean;
-    minLength?: boolean;
-    maxLength?: boolean;
-    allowHtml?: boolean;
-    allowScripts?: boolean;
-    validValues?: boolean;
-    format?: boolean;
-    pattern?: boolean;
-}): string;
+export default function cleanString(x: any, { required, minLength, maxLength, allowHtml, allowScripts, validValues, format, pattern }?: {
+    required?: boolean;
+    minLength?: boolean;
+    maxLength?: boolean;
+    allowHtml?: boolean;
+    allowScripts?: boolean;
+    validValues?: boolean;
+    format?: boolean;
+    pattern?: boolean;
+}): string;

package/types/getAllFiles.d.ts

@@ -1,4 +1,4 @@
-export default function getAllFiles(base: any, { dir, files, ignore, fileTypes }?: {
+export default function getAllFiles(base: any, { dir, files, ignore, fileTypes, root, }?: {
     dir?: string;
     files?: any[];
     ignore?: any[];

package/types/index.d.ts

@@ -1,101 +1,122 @@
-/**
- * This file is auto-generated by the build script.
- * It consolidates API type declarations for use in the application.
- * Do not edit manually.
- */
-import type _build from './build';
-import type _clean_array from './clean/array';
-import type _clean_boolean from './clean/boolean';
-import type _clean_buffer from './clean/buffer';
-import type _clean_custom from './clean/custom';
-import type _clean_integer from './clean/integer';
-import type _clean_number from './clean/number';
-import type _clean_object from './clean/object';
-import type _clean_string from './clean/string';
-import type _clean_timestamp from './clean/timestamp';
-import type _clean_uuid from './clean/uuid';
-import type _collectImports from './collectImports';
-import type _combineFiles from './combineFiles';
-import type _convertBytes from './convertBytes';
-import type _decrypt from './decrypt';
-import type _each from './each';
-import type _eachAsync from './eachAsync';
-import type _encrypt from './encrypt';
-import type _getAllFiles from './getAllFiles';
-import type _isUUID from './isUUID';
-import type _md5 from './md5';
-import type _password_check from './password/check';
-import type _password_hash from './password/hash';
-import type _setLocalEnvs from './setLocalEnvs';
-import type _shouldIgnore from './shouldIgnore';
-import type _thingType from './thingType';
-import type _toPennies from './toPennies';
-import type _utils_buildExportsTree from './utils/buildExportsTree';
-import type _utils_buildFileDataList from './utils/buildFileDataList';
-import type _utils_clean from './utils/clean';
-import type _utils_extractJSDocComment from './utils/extractJSDocComment';
-import type _utils_generateFile from './utils/generateFile';
-import type _utils_generateFlatExportLines from './utils/generateFlatExportLines';
-import type _utils_generateImportStatements from './utils/generateImportStatements';
-import type _utils_generateNamedExports from './utils/generateNamedExports';
-import type _utils_generateNamespaceCode from './utils/generateNamespaceCode';
-import type _utils_generateNamespaceExportLines from './utils/generateNamespaceExportLines';
-import type _uuid from './uuid';
-import type _validateSchema from './validateSchema';
-import type _wait from './wait';
-
-export declare const build: typeof _build;
-export declare const collectImports: typeof _collectImports;
-export declare const combineFiles: typeof _combineFiles;
-export declare const convertBytes: typeof _convertBytes;
-export declare const decrypt: typeof _decrypt;
-export declare const each: typeof _each;
-export declare const eachAsync: typeof _eachAsync;
-export declare const encrypt: typeof _encrypt;
-export declare const getAllFiles: typeof _getAllFiles;
-export declare const isUUID: typeof _isUUID;
-export declare const md5: typeof _md5;
-export declare const setLocalEnvs: typeof _setLocalEnvs;
-export declare const shouldIgnore: typeof _shouldIgnore;
-export declare const thingType: typeof _thingType;
-export declare const toPennies: typeof _toPennies;
-export declare const uuid: typeof _uuid;
-export declare const validateSchema: typeof _validateSchema;
-export declare const wait: typeof _wait;
-
-export declare const clean: {
-	array: typeof _clean_array;
-	boolean: typeof _clean_boolean;
-	buffer: typeof _clean_buffer;
-	custom: typeof _clean_custom;
-	integer: typeof _clean_integer;
-	number: typeof _clean_number;
-	object: typeof _clean_object;
-	string: typeof _clean_string;
-	timestamp: typeof _clean_timestamp;
-	uuid: typeof _clean_uuid;
-};
-
-export declare const password: {
-	check: typeof _password_check;
-	hash: typeof _password_hash;
-};
-
-export declare const utils: {
-	buildExportsTree: typeof _utils_buildExportsTree;
-	buildFileDataList: typeof _utils_buildFileDataList;
-	clean: typeof _utils_clean;
-	extractJSDocComment: typeof _utils_extractJSDocComment;
-	generateFile: typeof _utils_generateFile;
-	generateFlatExportLines: typeof _utils_generateFlatExportLines;
-	generateImportStatements: typeof _utils_generateImportStatements;
-	generateNamedExports: typeof _utils_generateNamedExports;
-	generateNamespaceCode: typeof _utils_generateNamespaceCode;
-	generateNamespaceExportLines: typeof _utils_generateNamespaceExportLines;
-};
-
-
-declare const _default: {
+/**
+ * This file is auto-generated by the build script.
+ * It consolidates API type declarations for use in the application.
+ * Do not edit manually.
+ */
+import type _build from './build';
+import type _clean_array from './clean/array';
+import type _clean_boolean from './clean/boolean';
+import type _clean_buffer from './clean/buffer';
+import type _clean_custom from './clean/custom';
+import type _clean_integer from './clean/integer';
+import type _clean_number from './clean/number';
+import type _clean_object from './clean/object';
+import type _clean_string from './clean/string';
+import type _clean_timestamp from './clean/timestamp';
+import type _clean_uuid from './clean/uuid';
+import type _collectImports from './collectImports';
+import type _combineFiles from './combineFiles';
+import type _convertBytes from './convertBytes';
+import type _decrypt from './decrypt';
+import type _each from './each';
+import type _eachAsync from './eachAsync';
+import type _encrypt from './encrypt';
+import type _getAllFiles from './getAllFiles';
+import type _isUUID from './isUUID';
+import type _md5 from './md5';
+import type _password_check from './password/check';
+import type _password_hash from './password/hash';
+import type _random_array from './random/array';
+import type _random_arrayValue from './random/arrayValue';
+import type _random_boolean from './random/boolean';
+import type _random_integer from './random/integer';
+import type _random_number from './random/number';
+import type _random_object from './random/object';
+import type _random_string from './random/string';
+import type _random_timestamp from './random/timestamp';
+import type _random_uuid from './random/uuid';
+import type _setLocalEnvs from './setLocalEnvs';
+import type _shouldIgnore from './shouldIgnore';
+import type _thingType from './thingType';
+import type _toPennies from './toPennies';
+import type _utils_buildExportsTree from './utils/buildExportsTree';
+import type _utils_buildFileDataList from './utils/buildFileDataList';
+import type _utils_clean from './utils/clean';
+import type _utils_extractJSDocComment from './utils/extractJSDocComment';
+import type _utils_generateFile from './utils/generateFile';
+import type _utils_generateFlatExportLines from './utils/generateFlatExportLines';
+import type _utils_generateImportStatements from './utils/generateImportStatements';
+import type _utils_generateNamedExports from './utils/generateNamedExports';
+import type _utils_generateNamespaceCode from './utils/generateNamespaceCode';
+import type _utils_generateNamespaceExportLines from './utils/generateNamespaceExportLines';
+import type _uuid from './uuid';
+import type _validateSchema from './validateSchema';
+import type _wait from './wait';
+
+export declare const build: typeof _build;
+export declare const collectImports: typeof _collectImports;
+export declare const combineFiles: typeof _combineFiles;
+export declare const convertBytes: typeof _convertBytes;
+export declare const decrypt: typeof _decrypt;
+export declare const each: typeof _each;
+export declare const eachAsync: typeof _eachAsync;
+export declare const encrypt: typeof _encrypt;
+export declare const getAllFiles: typeof _getAllFiles;
+export declare const isUUID: typeof _isUUID;
+export declare const md5: typeof _md5;
+export declare const setLocalEnvs: typeof _setLocalEnvs;
+export declare const shouldIgnore: typeof _shouldIgnore;
+export declare const thingType: typeof _thingType;
+export declare const toPennies: typeof _toPennies;
+export declare const uuid: typeof _uuid;
+export declare const validateSchema: typeof _validateSchema;
+export declare const wait: typeof _wait;
+
+export declare const clean: {
+	array: typeof _clean_array;
+	boolean: typeof _clean_boolean;
+	buffer: typeof _clean_buffer;
+	custom: typeof _clean_custom;
+	integer: typeof _clean_integer;
+	number: typeof _clean_number;
+	object: typeof _clean_object;
+	string: typeof _clean_string;
+	timestamp: typeof _clean_timestamp;
+	uuid: typeof _clean_uuid;
+};
+
+export declare const password: {
+	check: typeof _password_check;
+	hash: typeof _password_hash;
+};
+
+export declare const random: {
+	array: typeof _random_array;
+	arrayValue: typeof _random_arrayValue;
+	boolean: typeof _random_boolean;
+	integer: typeof _random_integer;
+	number: typeof _random_number;
+	object: typeof _random_object;
+	string: typeof _random_string;
+	timestamp: typeof _random_timestamp;
+	uuid: typeof _random_uuid;
+};
+
+export declare const utils: {
+	buildExportsTree: typeof _utils_buildExportsTree;
+	buildFileDataList: typeof _utils_buildFileDataList;
+	clean: typeof _utils_clean;
+	extractJSDocComment: typeof _utils_extractJSDocComment;
+	generateFile: typeof _utils_generateFile;
+	generateFlatExportLines: typeof _utils_generateFlatExportLines;
+	generateImportStatements: typeof _utils_generateImportStatements;
+	generateNamedExports: typeof _utils_generateNamedExports;
+	generateNamespaceCode: typeof _utils_generateNamespaceCode;
+	generateNamespaceExportLines: typeof _utils_generateNamespaceExportLines;
+};
+
+
+declare const _default: {
 	/**
 	 * Builds a file from the specified source directory and writes it to the destination file.
 	 *
@@ -107,19 +128,19 @@ declare const _default: {
 	 * @param {boolean} [options.includeComments=true] - Whether to include comments in the generated file.
 	 * @param {boolean} [options.dts=false] - Whether to generate TypeScript declaration files.
 	 * @returns {Promise<boolean>} A promise that resolves to true when the build is complete.
-	 */
-	build: typeof _build;
-	collectImports: typeof _collectImports;
-	combineFiles: typeof _combineFiles;
+	 */
+	build: typeof _build;
+	collectImports: typeof _collectImports;
+	combineFiles: typeof _combineFiles;
 	/**
 	 * Converts a given number of bytes into a more readable string format with appropriate units.
 	 *
 	 * @param {number} bytes - The number of bytes to convert.
 	 * @param {number} [precision=2] - The number of decimal places to include in the result.
 	 * @returns {string} The converted bytes in a string format with appropriate units.
-	 */
-	convertBytes: typeof _convertBytes;
-	decrypt: typeof _decrypt;
+	 */
+	convertBytes: typeof _convertBytes;
+	decrypt: typeof _decrypt;
 	/**
 	 * Iterates over elements of an array or properties of an object, invoking a callback for each element/property.
 	 * The iteration stops if the callback returns `false`.
@@ -128,48 +149,59 @@ declare const _default: {
 	 * @param {Object|Array} objectOrArray - The object or array to iterate over.
 	 * @param {Function} callback - The function to invoke per iteration. It is invoked with two arguments: (value, key/index).
 	 * @returns {void}
-	 */
-	each: typeof _each;
-	eachAsync: typeof _eachAsync;
-	encrypt: typeof _encrypt;
-	getAllFiles: typeof _getAllFiles;
-	isUUID: typeof _isUUID;
-	md5: typeof _md5;
-	setLocalEnvs: typeof _setLocalEnvs;
-	shouldIgnore: typeof _shouldIgnore;
-	thingType: typeof _thingType;
-	toPennies: typeof _toPennies;
-	uuid: typeof _uuid;
-	validateSchema: typeof _validateSchema;
-	wait: typeof _wait;
-	clean: {
-		array: typeof _clean_array,
-		boolean: typeof _clean_boolean,
-		buffer: typeof _clean_buffer,
-		custom: typeof _clean_custom,
-		integer: typeof _clean_integer,
-		number: typeof _clean_number,
-		object: typeof _clean_object,
-		string: typeof _clean_string,
-		timestamp: typeof _clean_timestamp,
-		uuid: typeof _clean_uuid,
-	},
-	password: {
-		check: typeof _password_check,
-		hash: typeof _password_hash,
-	},
-	utils: {
-		buildExportsTree: typeof _utils_buildExportsTree,
-		buildFileDataList: typeof _utils_buildFileDataList,
-		clean: typeof _utils_clean,
-		extractJSDocComment: typeof _utils_extractJSDocComment,
-		generateFile: typeof _utils_generateFile,
-		generateFlatExportLines: typeof _utils_generateFlatExportLines,
-		generateImportStatements: typeof _utils_generateImportStatements,
-		generateNamedExports: typeof _utils_generateNamedExports,
-		generateNamespaceCode: typeof _utils_generateNamespaceCode,
-		generateNamespaceExportLines: typeof _utils_generateNamespaceExportLines,
-	},
-};
-
-export default _default;
+	 */
+	each: typeof _each;
+	eachAsync: typeof _eachAsync;
+	encrypt: typeof _encrypt;
+	getAllFiles: typeof _getAllFiles;
+	isUUID: typeof _isUUID;
+	md5: typeof _md5;
+	setLocalEnvs: typeof _setLocalEnvs;
+	shouldIgnore: typeof _shouldIgnore;
+	thingType: typeof _thingType;
+	toPennies: typeof _toPennies;
+	uuid: typeof _uuid;
+	validateSchema: typeof _validateSchema;
+	wait: typeof _wait;
+	clean: {
+		array: typeof _clean_array,
+		boolean: typeof _clean_boolean,
+		buffer: typeof _clean_buffer,
+		custom: typeof _clean_custom,
+		integer: typeof _clean_integer,
+		number: typeof _clean_number,
+		object: typeof _clean_object,
+		string: typeof _clean_string,
+		timestamp: typeof _clean_timestamp,
+		uuid: typeof _clean_uuid,
+	},
+	password: {
+		check: typeof _password_check,
+		hash: typeof _password_hash,
+	},
+	random: {
+		array: typeof _random_array,
+		arrayValue: typeof _random_arrayValue,
+		boolean: typeof _random_boolean,
+		integer: typeof _random_integer,
+		number: typeof _random_number,
+		object: typeof _random_object,
+		string: typeof _random_string,
+		timestamp: typeof _random_timestamp,
+		uuid: typeof _random_uuid,
+	},
+	utils: {
+		buildExportsTree: typeof _utils_buildExportsTree,
+		buildFileDataList: typeof _utils_buildFileDataList,
+		clean: typeof _utils_clean,
+		extractJSDocComment: typeof _utils_extractJSDocComment,
+		generateFile: typeof _utils_generateFile,
+		generateFlatExportLines: typeof _utils_generateFlatExportLines,
+		generateImportStatements: typeof _utils_generateImportStatements,
+		generateNamedExports: typeof _utils_generateNamedExports,
+		generateNamespaceCode: typeof _utils_generateNamespaceCode,
+		generateNamespaceExportLines: typeof _utils_generateNamespaceExportLines,
+	},
+};
+
+export default _default;

package/types/random/array.d.ts

@@ -0,0 +1,10 @@
+export default randomArray;
+declare function randomArray({ items, min, max }?: {
+    items?: {
+        type: string;
+        minLength: number;
+        maxLength: number;
+    };
+    min?: number;
+    max?: number;
+}): any[];

package/types/random/arrayValue.d.ts

@@ -0,0 +1,2 @@
+declare function _default(array: any): any;
+export default _default;

package/types/random/boolean.d.ts

@@ -0,0 +1,2 @@
+declare function _default(): boolean;
+export default _default;

package/types/random/integer.d.ts

@@ -0,0 +1,5 @@
+declare function _default({ min, max, }?: {
+    min?: number;
+    max?: number;
+}): number;
+export default _default;

package/types/random/number.d.ts

@@ -0,0 +1,6 @@
+declare function _default({ min, max, decimalPlaces }?: {
+    min?: number;
+    max?: number;
+    decimalPlaces?: number;
+}): number;
+export default _default;

package/types/random/object.d.ts

@@ -0,0 +1,4 @@
+export default randomObject;
+declare function randomObject({ properties, }?: {
+    properties?: {};
+}): {};

package/types/random/string.d.ts

@@ -0,0 +1,5 @@
+declare function _default({ minLength, maxLength, }?: {
+    minLength?: number;
+    maxLength?: number;
+}): string;
+export default _default;

package/types/random/timestamp.d.ts

@@ -0,0 +1,6 @@
+declare function _default({ maxDays, minDays, future }?: {
+    maxDays?: number;
+    minDays?: number;
+    future?: boolean;
+}): string;
+export default _default;

package/types/random/uuid.d.ts

@@ -0,0 +1,2 @@
+declare function _default(): string;
+export default _default;

package/types/utils/clean.d.ts

@@ -1,27 +1,27 @@
-declare namespace _default {
-    export { cleanArray as array };
-    export { cleanObject as object };
-    export { cleanBoolean as boolean };
-    export { cleanInteger as integer };
-    export { cleanNumber as number };
-    export { cleanString as string };
-    export { cleanTimestamp as timestamp };
-    export { cleanUUID as uuid };
-}
-export default _default;
-declare function cleanArray(arr: any, schema?: {}, { testMode, allOrNothing, path }?: {
-    testMode?: boolean;
-    allOrNothing?: boolean;
-    path?: string;
-}): any[];
-declare function cleanObject(obj: any, schema: any, { testMode, allOrNothing, path }?: {
-    testMode?: boolean;
-    allOrNothing?: boolean;
-    path?: string;
-}): {};
-import cleanBoolean from '../clean/boolean.js';
-import cleanInteger from '../clean/integer.js';
-import cleanNumber from '../clean/number.js';
-import cleanString from '../clean/string.js';
-import cleanTimestamp from '../clean/timestamp.js';
-import cleanUUID from '../clean/uuid.js';
+declare namespace _default {
+    export { cleanArray as array };
+    export { cleanObject as object };
+    export { cleanBoolean as boolean };
+    export { cleanInteger as integer };
+    export { cleanNumber as number };
+    export { cleanString as string };
+    export { cleanTimestamp as timestamp };
+    export { cleanUUID as uuid };
+}
+export default _default;
+declare function cleanArray(arr: any, schema?: {}, { testMode, allOrNothing, path }?: {
+    testMode?: boolean;
+    allOrNothing?: boolean;
+    path?: string;
+}): any[];
+declare function cleanObject(obj: any, schema: any, { testMode, allOrNothing, path }?: {
+    testMode?: boolean;
+    allOrNothing?: boolean;
+    path?: string;
+}): {};
+import cleanBoolean from '../clean/boolean.js';
+import cleanInteger from '../clean/integer.js';
+import cleanNumber from '../clean/number.js';
+import cleanString from '../clean/string.js';
+import cleanTimestamp from '../clean/timestamp.js';
+import cleanUUID from '../clean/uuid.js';

package/types/wait.d.ts

@@ -1 +1 @@
-export default function wait(ms: any): Promise<any>;
+export default function wait(ms: any): Promise<any>;