aotrautils 0.0.1900 → 0.0.1902

aotrautils/.gitignore

@@ -0,0 +1 @@
+/node_modules/

aotrautils/aotrautils.build.js

@@ -1,6 +1,6 @@
 
 
-/*utils COMMONS library associated with aotra version : «1_29072022-2359 (25/07/2026-23:51:45)»*/
+/*utils COMMONS library associated with aotra version : «1_29072022-2359 (26/07/2026-02:34:09)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -29,7 +29,7 @@ if(typeof(window)==="undefined")	window=global;
 
 //=========================================================================
 // GLOBAL CONSTANTS :
-PERFORM_TESTS_ON_LIBRARY=false;
+window.PERFORM_TESTS_ON_LIBRARY=false;
 
 //FLATTEN / UNFLATTEN JSON CONSTANTS :
 
@@ -2690,7 +2690,7 @@ window.startsWith=window.aotest({
 	scenario2ok : [ [ "https://example.com", "http://" ], false ]
 }, function(str, subStr){
 	return str.lastIndexOf(subStr, 0) === 0;
-}, !PERFORM_TESTS_ON_LIBRARY);
+}, !window.PERFORM_TESTS_ON_LIBRARY);
 
 
 
@@ -2860,7 +2860,7 @@ scenario4 : [ [ " test1  \r\r\ntest2", "compactHTML" ], "test1 \n\n\ntest2" ]
 	
 	// «Soft» mode is default mode :
 	return str.replace(/[\s\t\n\r]+/igm, " ").trim();
-}, !PERFORM_TESTS_ON_LIBRARY);
+}, !window.PERFORM_TESTS_ON_LIBRARY);
 
 
 window.dec2hex=function(d){
@@ -2873,7 +2873,7 @@ window.hex2dec=function(h){
 
 
 window.hashSafe=function(str){
-	if(typeof(crypto)==="undefined" || typeof(crypto.createHash)==="undefined"){
+	if(typeof(window.crypto)==="undefined" || typeof(window.crypto.createHash)==="undefined"){
 
 //		// TRACE
 //		console.log("ERROR : NodeJS installation does not include «crypto» node module dependency. Trying to use client-side hashing infrastructure.");
@@ -2898,7 +2898,7 @@ window.hashSafe=function(str){
 		}
 		return getHashedString(str);
 	}
-	return crypto.createHash("md5").update(str).digest("hex");
+	return window.crypto.createHash("md5").update(str).digest("hex");
 }
 
 
@@ -3414,7 +3414,7 @@ window.aotest({
 		dummy : "obj1"
 	} ], false ]
 
-}, isArray, !PERFORM_TESTS_ON_LIBRARY);
+}, isArray, !window.PERFORM_TESTS_ON_LIBRARY);
 
 window.arraysEqual=function(array1, array2){
 	if(!array1 && !array2)
@@ -3500,7 +3500,7 @@ window.aotest({
 		dummy : "tab8"
 	} ], true ]
 
-}, arraysEqual, !PERFORM_TESTS_ON_LIBRARY);
+}, arraysEqual, !window.PERFORM_TESTS_ON_LIBRARY);
 
 window.objectsEqual=window.aotest({
 	name : "objectsEqual",
@@ -3575,7 +3575,7 @@ window.objectsEqual=window.aotest({
 	}
 
 	return true;
-}, !PERFORM_TESTS_ON_LIBRARY);
+}, !window.PERFORM_TESTS_ON_LIBRARY);
 
 
 
@@ -3698,7 +3698,7 @@ Math.coerceInRange=window.aotest({
 		value=Math.abs(value);
 	}
 	return Math.min(Math.max(value, min), max);
-}, !PERFORM_TESTS_ON_LIBRARY);
+}, !window.PERFORM_TESTS_ON_LIBRARY);
 
 
 Math.getMinMax=function(strMinMaxRange, separator="¬>"){
@@ -5470,7 +5470,7 @@ AOTRAUTILS_LIB_IS_LOADED=true;
 
 	
 
-/*utils CLIENT library associated with aotra version : «1_29072022-2359 (25/07/2026-23:51:45)»*/
+/*utils CLIENT library associated with aotra version : «1_29072022-2359 (26/07/2026-02:34:09)»*/
 /*-----------------------------------------------------------------------------*/
 /* ## Utility global methods in a browser (htmljs) client environment.
  *
@@ -5501,7 +5501,7 @@ if(typeof(window)==="undefined")	window=global;
 // GLOBAL CONSTANTS :
 
 const APOSTROPHE="’";
-PERFORM_TESTS_ON_LIBRARY=false;
+window.PERFORM_TESTS_ON_LIBRARY=false;
 
 // CAUTION ! Apparently nodejs ECMAscript does not do lazy evaluation when it's for throwing declaraion exceptions (it's logical, when you think a second about it..)
 function isUserMediaAvailable(){
@@ -5515,7 +5515,7 @@ if(typeof aotest === "undefined"){
 	// If aotest library is not available, then we replace aotest calls with simple tested function calls :
 	aotest=function(testcase,testedFunction){ return testedFunction; };
 	// TRACE IF NEEDED
-	if(PERFORM_TESTS_ON_LIBRARY)	console.log("WARN : aotest library not found, deactivating aotest unit test abilities.");
+	if(window.PERFORM_TESTS_ON_LIBRARY)	console.log("WARN : aotest library not found, deactivating aotest unit test abilities.");
 }
 if(typeof monitorProgression === "undefined"){
 	monitorProgression=function(progressionTotalAmount,monitoredFunction){ return monitoredFunction; };
@@ -5826,7 +5826,7 @@ cssStringToJQueryObject=aotest({
 		result[name.replace("*/", "").trim()]=value;
 	}
 	return result;
-}, !PERFORM_TESTS_ON_LIBRARY);
+}, !window.PERFORM_TESTS_ON_LIBRARY);
 
 // HTML elements management :
 
@@ -6388,7 +6388,7 @@ var isURLHttps=aotest(
 // Function definition
 , function(url){
 	return startsWith(url.toLowerCase(), "https://");
-}, !PERFORM_TESTS_ON_LIBRARY);
+}, !window.PERFORM_TESTS_ON_LIBRARY);
 
 
 /*DEPRECATED, use new URL("...") instead !*/
@@ -12296,7 +12296,7 @@ window.gpioUtils = {
 
 		const gpioFilePath = GPIO_BASE_PATH + "/gpio" + gpioNumber;
 		const setDirection = () => {
-			fs.writeFile(gpioFilePath + "/direction", mode + "", (error) => {
+			window.fs.writeFile(gpioFilePath + "/direction", mode + "", (error) => {
 				if (error) {
 					// TRACE
 					lognow("ERROR : Could not set mode «" + mode + "» on pin «" + gpioNumber + "». Abording setup.", error);
@@ -12306,11 +12306,11 @@ window.gpioUtils = {
 			});
 		};
 
-		fs.access(gpioFilePath, fs.constants.F_OK, (error) => {
+		window.fs.access(gpioFilePath, window.fs.constants.F_OK, (error) => {
 			if (error) {
 				// Case export file does not exists 
 				// In this case we export the gpio pin :
-				fs.writeFile(GPIO_BASE_PATH + "/export", gpioNumber + "", (error) => {
+				window.fs.writeFile(GPIO_BASE_PATH + "/export", gpioNumber + "", (error) => {
 					if (error) {
 						// TRACE
 						lognow("ERROR : Could not export pin «" + gpioNumber + "». Abording setup.", error);
@@ -12333,7 +12333,7 @@ window.gpioUtils = {
 		}
 
 		const gpioFilePath = GPIO_BASE_PATH + "/gpio" + gpioNumber;
-		fs.access(gpioFilePath, fs.constants.F_OK, (error) => {
+		window.fs.access(gpioFilePath, window.fs.constants.F_OK, (error) => {
 			if (error) {
 				// Case export file does not exists
 				// TRACE
@@ -12342,7 +12342,7 @@ window.gpioUtils = {
 			}
 			// Case export file already exists 
 			// In this case we export the gpio pin :
-			fs.writeFile(GPIO_BASE_PATH + "/unexport", gpioNumber + "", (error) => {
+			window.fs.writeFile(GPIO_BASE_PATH + "/unexport", gpioNumber + "", (error) => {
 				if (error) {
 					// TRACE
 					lognow("ERROR : Could not unexport pin «" + gpioNumber + "».", error);
@@ -12363,7 +12363,7 @@ window.gpioUtils = {
 
 
 		const gpioFilePath = GPIO_BASE_PATH + "/gpio" + gpioNumber;
-		fs.access(gpioFilePath, fs.constants.F_OK, (error) => {
+		window.fs.access(gpioFilePath, window.fs.constants.F_OK, (error) => {
 			if (error) {
 				// Case export file does not exists
 				// TRACE
@@ -12376,7 +12376,7 @@ window.gpioUtils = {
 
 			// Case export file already exists 
 			// In this case we export the gpio pin :
-			fs.writeFile(gpioFilePath + "/value", stateNumber + "", (error) => {
+			window.fs.writeFile(gpioFilePath + "/value", stateNumber + "", (error) => {
 				if (error) {
 					// TRACE
 					lognow("ERROR : Could not write «" + stateNumber + "» on pin «" + gpioNumber + "».", error);
@@ -12396,7 +12396,7 @@ window.gpioUtils = {
 		}
 
 		const gpioFilePath = GPIO_BASE_PATH + "/gpio" + gpioNumber;
-		fs.access(gpioFilePath, fs.constants.F_OK, (error) => {
+		window.fs.access(gpioFilePath, window.fs.constants.F_OK, (error) => {
 			if (error) {
 				// Case export file does not exists
 				// TRACE
@@ -12406,7 +12406,7 @@ window.gpioUtils = {
 
 			// Case export file already exists 
 			// In this case we export the gpio pin :
-			fs.readFile(gpioFilePath + "/value", "utf-8", (error, data) => {
+			window.fs.readFile(gpioFilePath + "/value", "utf-8", (error, data) => {
 
 				//				// DBG
 				//				lognow("DEBUG : read value:"+data);
@@ -13291,7 +13291,7 @@ createOritaMicroClient=function(url, port, isNode=false, staticMicroClientIdPara
 
 
 
-/*utils GEOMETRY library associated with aotra version : «1_29072022-2359 (25/07/2026-23:51:45)»*/
+/*utils GEOMETRY library associated with aotra version : «1_29072022-2359 (26/07/2026-02:34:09)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -14376,10 +14376,10 @@ function rayVsUnitSphereClosestPoint(p, r) {
 // MUST REMAIN AT THE END OF THIS LIBRARY FILE !
 
 AOTRAUTILS_GEOMETRY_LIB_IS_LOADED=true;
-/*utils 3D library associated with aotra version : «1_29072022-2359 (25/07/2026-23:51:45)»*/
+/*utils 3D library associated with aotra version : «1_29072022-2359 (26/07/2026-02:34:09)»*/
 /*-----------------------------------------------------------------------------*/
 
-/*utils AI library associated with aotra version : «1_29072022-2359 (25/07/2026-23:51:45)»*/
+/*utils AI library associated with aotra version : «1_29072022-2359 (26/07/2026-02:34:09)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -14639,7 +14639,7 @@ getLLMAPIClient=(modelName, apiURL, agentRole, defaultPrompt, llmProviderName=DE
 
 
 
-/*utils CONSOLE library associated with aotra version : «1_29072022-2359 (25/07/2026-23:51:45)»*/
+/*utils CONSOLE library associated with aotra version : «1_29072022-2359 (26/07/2026-02:34:09)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -16285,7 +16285,7 @@ window.getCurrentLevelPrototypeNameForAORTACServerCell=()=>{
 
 
 // COMPATIBILITY browser javascript / nodejs environment :
-if(typeof(window)==="undefined")	window=global;	
+if(typeof(window)==="undefined")	window=global;
 
 
 // ==================================================================================================================
@@ -16614,7 +16614,8 @@ function capitalize(str){
 // COMPATIBILITY browser javascript / nodejs environment :
 if(typeof(window)==="undefined")	window=global;	
 
-
+// Cryptography hashing utils :
+window.crypto=require("node:crypto");
 
 // OLD : socket.io :
 // https://stackoverflow.com/questions/31156884/how-to-use-https-on-node-js-using-express-socket-io
@@ -16643,16 +16644,13 @@ const ADD_CORS_HEADER=true;
 console.log("DEBUG : Importing «fs» dependency.");
 
 
-if(typeof(require)!=="undefined" && typeof(fs)==="undefined" ){
+if(typeof(require)!=="undefined" && typeof(window.fs)==="undefined" ){
 	window.fs=require("fs");
 }
 
-// For debug (WORKAROUND):
-fs=window.fs;
-
 
 // Nodejs filesystem utils :
-if(typeof(fs)==="undefined"){
+if(typeof(window.fs)==="undefined"){
 	// TRACE
 	console.log("WARN : Could not find the nodejs dependency «fs», aborting persister setup.");
 	window.getPersister=()=>{	return null;	};
@@ -16683,7 +16681,7 @@ if(typeof(fs)==="undefined"){
 		
 				try{
 
-					resultFlat=fs.readFileSync(path, FILE_ENCODING);
+					resultFlat=window.fs.readFileSync(path, FILE_ENCODING);
 					
 				}catch(error){
 					// TRACE
@@ -16725,7 +16723,7 @@ if(typeof(fs)==="undefined"){
 				
 				
 				let path=self.getPath(clientId,repositoryName);
-				fs.writeFile(path, dataFlatStr, FILE_ENCODING, (error) => {
+				window.fs.writeFile(path, dataFlatStr, FILE_ENCODING, (error) => {
 			    if(error){
 			    	// TRACE
 						console.log("ERROR : Could not write file «"+path+"»:",error);
@@ -16745,12 +16743,12 @@ if(typeof(fs)==="undefined"){
 
 
 window.fileExists=(filePath)=>{
-	if(typeof(fs)=="undefined"){
+	if(typeof(window.fs)=="undefined"){
 		// TRACE
 		lognow("ERROR : «fs» node dependency is not available ! Cannot test if file exists.");
 		return null;
 	}
-	return fs.existsSync(filePath);
+	return window.fs.existsSync(filePath);
 };
 
 
@@ -16778,16 +16776,12 @@ window.getURLOrConsoleParameter=(parameterName)=>{
 
 getConsoleServerParams=function(portParam=null, certPathParam=null, keyPathParam=null, ignoreConsoleArgs=false, argsOffset=0){
 	
-	// Node dependencies :
-	// https=require("https");
-	// fs=require("fs");
-	
-	if(typeof(https)==="undefined"){
+	if(typeof(window.https)==="undefined"){
 		// TRACE
 		console.log("WARN : Could not find the nodejs dependency «https», aborting SSL setup.");
 		return null;
 	}
-	if(typeof(fs)==="undefined"){
+	if(typeof(window.fs)==="undefined"){
 		// TRACE
 		console.log("WARN : Could not find the nodejs dependency «fs», aborting SSL setup.");
 		return null;
@@ -16816,8 +16810,8 @@ getConsoleServerParams=function(portParam=null, certPathParam=null, keyPathParam
 	result.sslOptions=null;
 	if(result.isSecure){
 		result.sslOptions={
-			cert: fs.readFileSync(result.certPath),
-			key: fs.readFileSync(result.keyPath),
+			cert:window.fs.readFileSync(result.certPath),
+			key:window.fs.readFileSync(result.keyPath),
 		};
 	}
 	
@@ -17217,15 +17211,15 @@ launchNodeHTTPServer=function(port, doOnConnect=null, doOnFinalizeServer=null, d
 	const EXCLUDED_FILENAMES_PARTS=[".keyHash.",".pem"];
 	
 	
-	if(typeof(https)==="undefined"){
+	if(typeof(window.https)==="undefined"){
 		// TRACE
 		console.log("«https» SERVER library not called yet, calling it now.");
-		https=require("https");
+		window.https=require("https");
 	}
-	if(typeof(http)==="undefined"){
+	if(typeof(window.http)==="undefined"){
 		// TRACE
 		console.log("«http» SERVER library not called yet, calling it now.");
-		http=require("http");
+		window.http=require("http");
 	}
 	
 	
@@ -17266,13 +17260,13 @@ launchNodeHTTPServer=function(port, doOnConnect=null, doOnFinalizeServer=null, d
 		if(addCORSHeader)		headers["Access-Control-Allow-Origin"]="*";
 		
     
-    fs.readFile(filePath, function(error, fileContent){
+    window.fs.readFile(filePath, function(error, fileContent){
       if(error){
           if(error.code=="ENOENT"){
           	// TRACE
           	console.log("ERROR 404 file not found :"+filePath);
           	
-            fs.readFile("./404.html", function(error, fileContent){
+            window.fs.readFile("./404.html", function(error, fileContent){
             	response.writeHead(200, headers);
               response.end(fileContent, "utf-8");
             });
@@ -17311,12 +17305,12 @@ launchNodeHTTPServer=function(port, doOnConnect=null, doOnFinalizeServer=null, d
 	
 	let listenableServer;
 	if(sslOptions){
-		let httpsServer=https.createServer(sslOptions, handler).listen(port);
+		let httpsServer=window.https.createServer(sslOptions, handler).listen(port);
 		// TRACE
 		console.log("INFO : SERVER : HTTPS Server launched and listening on port " + port + "!");
 		listenableServer=httpsServer;
 	}else{
-		let httpServer=http.createServer(handler).listen(port);
+		let httpServer=window.http.createServer(handler).listen(port);
 		// TRACE
 		console.log("INFO : SERVER : HTTP Server launched and listening on port " + port + "!");
 		listenableServer=httpServer;
@@ -17474,14 +17468,14 @@ initNodeServerInfrastructureWrapper=function(doOnClientConnection=null, doOnFina
 		// Eventual encryption options : 
 		let sslOptions=null; 
 		if(!isForceUnsecure){
-			if(typeof(fs)==="undefined"){
+			if(typeof(window.fs)==="undefined"){
 				// TRACE
 				lognow("ERROR : «fs» node subsystem not present, cannot access files. Aborting SSL configuration of server.");
 			}else{
 				try{
 		  		sslOptions={
-		  			cert: fs.readFileSync(certPath, {encoding: "utf8"}),
-		  			key: fs.readFileSync(keyPath, {encoding: "utf8"}),
+		  			cert:window.fs.readFileSync(certPath, {encoding: "utf8"}),
+		  			key:window.fs.readFileSync(keyPath, {encoding: "utf8"}),
 		  		};
 				}catch(exception){
 					// TRACE

aotrautils/package-lock.json

@@ -1,12 +1,12 @@
 {
 	"name": "aotrautils",
-	"version": "0.0.1900",
+	"version": "0.0.1902",
 	"lockfileVersion": 3,
 	"requires": true,
 	"packages": {
 		"": {
 			"name": "aotrautils",
-			"version": "0.0.1900",
+			"version": "0.0.1902",
 			"license": "HGPL-1.0",
 			"dependencies": {
 				"atob": "^2.1.2",

aotrautils/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "aotrautils",
-	"version": "0.0.1900",
+	"version": "0.0.1902",
 	"main": "aotrautils.build.js",
 	"description": "A library for vanilla javascript utils (client-side) used in aotra javascript CMS",
 	"author": "Jeremie Ratomposon <info@alqemia.com> (https://alqemia.com)",