aotrautils 0.0.52 → 0.0.55

aotrautils/aotrautils.build.js

@@ -1,6 +1,6 @@
 
 
-/*utils CLIENT library associated with aotra version : «1.0.0.000 (11/07/2022-23:45:37)»*/
+/*utils CLIENT library associated with aotra version : «1.0.0.000 (12/07/2022-01:46:29)»*/
 /*-----------------------------------------------------------------------------*/
 /* ## Utility global methods in a browser (htmljs) client environment.
  *
@@ -55,433 +55,160 @@ if(typeof monitorProgression === "undefined"){
 
 
 
+
+
+
 // NOT AOTESTABLE !
-//TODO : develop :
-//getHashedString=monitorProgression(100000,
-window.getHashedString=function(str,/*OPTIONAL*/isHeavyTreatment){
-	
-	//CAUTION : YOU MUST *NOT* CHANGE THIS VALUE, UNLESS THE HASH HEAVY TREATMENT VALUE IN YOUR AOTRA SERVER-SIDE CODEIS THE SAME !
-	const HEAVY_TREATMENT_LOOP_COUNT=100000;
-	
-	if(isHeavyTreatment){
 
-		// If needed, we make sure the hashing will take a long time, so that
-		// if the private salt key is leaked, it will be fairly difficult to crack
-		// password write protection and content encryption :
-		
-		let result=str;
-		for(var i=0;i<HEAVY_TREATMENT_LOOP_COUNT;i++){
-			result=getHashedString(result,false);
-		}
+//Works, but doesn't compile under PhoneGap...:
+//function getURLParameter(nameParam){
+//var name=encodeURIComponent(nameParam);
+//return decodeURIComponent(
+//(
+//new RegExp('[?|&]' + name + '=' + '([^&;]+?)(&|#|;|$)' )
+//.exec(window.location.search)
+//|| [,""]
+//)[1]
+//.replace(/\+/g, '%20')
+//)||null;
+//}
 
-		
-		return result;
-		
-	}else{
-	
-		
-		// SHA-256 hash (sucks less) :
-		// DEPENDENCY : SJCL JS libray (Stanford Javascript Crypto Library)
-		if(typeof(sjcl)!="undefined"){
-			let result=sjcl.codec.hex.fromBits(sjcl.hash.sha256.hash(str));
-			
-			// TODO : develop :
-//			hash.progressionMonitor.progress(1);
-	
-			
-			return result;
-		}
-		
-		// if not found : MD5 hash (sucks) :
-		//TRACE
-		log("WARN : Could not find SHA hashing, using MD5. This sucks, and this very likely will prevent your aotra client to be able to write data to aotra server.");
-		
-		return hex_md5(str);
-	}
+//...so we replace it with another function that is supposed to do the same
+//thing :
+function getURLParameter(nameParam){
+	var name=nameParam;
+	if (name=new RegExp("[?&]" + encodeURIComponent(name) + "=([^&]*)").exec(location.search))
+		return decodeURIComponent(name[1]);
+	return null;
 }
-//);
 
-function encrypt(strToEncrypt,key,/*OPTIONAL*/mode){
-	if(!mode || typeof(sjcl)=="undefined")	mode="xor";
-	mode=mode.trim();
 
-	if(contains(mode,"aes") && contains(mode,"xor")){
 
-		// XOR :
-		var xorStr=btoa(encodeXORNoPattern(strToEncrypt,key));	
-		
-		var aesStr=
-			// AES
-			sjcl.encrypt(key,xorStr);
 
-		return aesStr;
-	}
+// A little method to help i18ning aotra user interface :
+const I18N_REPOSITORY_VARIABLE_NAME="I18N_KEYS";
+function i18n(languagesAndStrings, langParam=null){
 	
-	//	DEPENDENCY : SJCL JS libray (Stanford Javascript Crypto Library)
-	if(mode==="aes")
-		return sjcl.encrypt(key,strToEncrypt);
-	return btoa(encodeXORNoPattern(strToEncrypt,key));
-
-}
-
-function decrypt(strToDecrypt,key,/*OPTIONAL*/mode){
-	if(!mode || typeof(sjcl)=="undefined")	mode="xor";
-	mode=mode.trim();
+	// ******************* CONFIG ******************* 
+	const PREFERED_LANGUAGE="fr"; // My Quebecer wife (love on her for ever and beyond) forced me to set this...(I'm French.)
+	
+	const NO_TRANSLATION_LABEL="NO TRANSLATION FOUND";
+	
+	const ADD_SYSTEMATICALLY_TO_REPOSITORY=true;
+	const MAX_CHARACTERS_FOR_TRANSLATION_KEY=64; // Really if you have more than 64 characters in commons, then it really should be the same string !
 
-	if(contains(mode,"aes") && contains(mode,"xor")){
-		
-		// AES
-		var aesStr=sjcl.decrypt(key,strToDecrypt);
-		
-		var xorStr=
-			// XOR :
-			encodeXORNoPattern(atob(aesStr),key);
+	// ***************** END CONFIG ***************** 
 
-		return xorStr;
-		
+	
+	if(!languagesAndStrings){
+		// TRACE
+		console.log("ERROR : No parameter for i18n provided!",languagesAndStrings);
+		return NO_TRANSLATION_LABEL;
 	}
 	
-	//	DEPENDENCY : SJCL JS libray (Stanford Javascript Crypto Library)
-	if(mode==="aes")
-		return sjcl.decrypt(key,strToDecrypt);
-	return encodeXORNoPattern(atob(strToDecrypt),key);
+	let lang=null;
+	if(langParam){
+		lang=langParam;
+	}else{
+		// Parameters priority :
+		if(window){
+			if(window.getURLParameter){
+				lang=nonull(window.getURLParameter("language"), window.getURLParameter("lang"));
+			}
+			if(!lang && (window.language || window.lang)){
+				lang=nonull(window.language, window.lang);
+			}
+		}else if(global){	// (NodeJS compatibility)
+			if(global.getURLParameter){
+				lang=nonull(global.getURLParameter("language"), global.getURLParameter("lang"));
+			}
+			if(!lang && (global.language || global.lang)){
+				lang=nonull(global.language, global.lang);
+			}
+		}
+		lang=nonull(lang, PREFERED_LANGUAGE);
+	}
 	
+	if(contains(["capitalize","append"],lang)){
+		// TRACE
+		console.log("WARN : Language parameter has for value a reserved attribute keyword, using default language «"+PREFERED_LANGUAGE+"»");
+		lang=PREFERED_LANGUAGE;
+	}
 	
-}
-
-function encodeXORNoPattern(strToEncode,key){
-	let result="";
-	let keyChunk=key;
-	let keyLength=keyChunk.length;
-	let previousChars="";
-	let cnt=0;
-	for(let i=0;i<strToEncode.length;i++){
-		let char=strToEncode.charAt(i);
-		let keyByte=keyChunk.charAt(cnt);
+	
+	let result=null;
+	
+	
+	if(!isString(languagesAndStrings)){ // Case direct i18n translation, with no translation keys :
 		
-		result+=String.fromCharCode(char.charCodeAt(0)^keyByte.charCodeAt(0));
+		result=languagesAndStrings[lang];
+	
+		if (!result){
+			// TRACE
+			console.log("ERROR : No label found for language «"+lang+"»!",languagesAndStrings);
+		}
+	
+		if (!result){
+			for(key in languagesAndStrings){
+				if (!languagesAndStrings.hasOwnProperty(key))
+					continue;
+				// We take the first that we find, in the other languages:
+				result=languagesAndStrings[key];
+				break;
+			}
+		}
+
+		if (!result)	return NO_TRANSLATION_LABEL;
 		
-		if(cnt%keyLength===(keyLength-1)){
-			cnt=0;
-			// NO : TOO LONG TREATMENT !: We hash with all the previous blocks too :
-			// We hash with a character of the previous chunk (they add up at each new chunk):
-			keyChunk=getHashedString(previousChars+keyChunk);
 		
-			previousChars+=keyChunk.charAt(keyChunk.length-1);
-		}else{
-			cnt++;
+		// We add this «rogue» usage of i18n to the whole repository at all useful ends :
+		if(ADD_SYSTEMATICALLY_TO_REPOSITORY){
+//		let declarable={};
+			let maxLength=Math.min(result.length, MAX_CHARACTERS_FOR_TRANSLATION_KEY);
+			let key=toConvention("camel", result.substring(0,maxLength).toLowerCase() );
+//		let calculatedKey=radicalKey+"_"+getUUID("short");
+//		declarable[calculatedKey]=languagesAndStrings;
+			i18n.declareSingleEntry(key, languagesAndStrings);
 		}
+
+		// Eventual post-treatments :
+		if(languagesAndStrings.capitalize)	result=capitalize(result);
+		if(languagesAndStrings.append)			result+=languagesAndStrings.append;
+
+		return result;
 	}
-	return result;
-}
+	// else // Case we use translation keys : (here, languagesAndStrings parameter holds just the wished translation key)
 
-function generateRandomString(length,/*NULLABLE*/mode){
 	
-	// This list must be very conservative, because  we want to be able to pass it through GET URLs !
-	// OLD (not enough conservative ?) : const ALLOWED_CHARS="abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0912346789_-£¢¤¬²³¼½¾";
-	const ALLOWED_CHARS="abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0912346789!-:;";
+	let repository=(window?window:global)[I18N_REPOSITORY_VARIABLE_NAME];
+	if(!repository){
+		// TRACE
+		console.log("ERROR : No repository variable found for repository «"+I18N_REPOSITORY_VARIABLE_NAME+"»!");
+		return NO_TRANSLATION_LABEL;
+	}
 	
+	// OLD (ie. splitted format :)
+//		let repositoryForLang=repository[lang];
+//		if (!repositoryForLang){
+//			// TRACE
+//			console.log("ERROR : No translation found for language «"+lang+"»!",languagesAndStrings);
+//			return NO_TRANSLATION_LABEL;
+//		}
+//		result=repositoryForLang[languagesAndStrings]; // Here, languagesAndStrings is just a bundle key.
+//		if (!result)	return NO_TRANSLATION_LABEL+" (for key «"+languagesAndStrings+"»)";
 	
-	if(typeof(length)==="string"){
-		if(contains(length,"->")){
-			length=Math.getRandomInRange(length);
-		}else{
-			length=64;
-		}
+	let languagesAndStringsForTranslationKey=repository[languagesAndStrings];
+	if (!languagesAndStringsForTranslationKey){
+		// SILENT ERROR :
+//		// TRACE
+//		console.log("ERROR : No translation found for key «"+languagesAndStrings+"» for language «"+lang+"»!");
+//	NO, OLD : return NO_TRANSLATION_LABEL;
+		return languagesAndStrings;
 	}
+	result=i18n(languagesAndStringsForTranslationKey, lang); // Since we use the same format !
 	
-	var result="";
-
-	if(mode==="simple"){
-		
-		for(var i=0;i<length;i++){
-			var	value=Math.getRandomInArray(ALLOWED_CHARS);
-			result+=value;
-		}
-		
-		return result;
-	}else if(mode==="human"){
-		
-		const markovGraph={
-			// For simplicity sakes, we ignore the consonants and vowels doubling possibilities:
-			consonants:{// They always accept vowels at their following
-				// Indicate ^ to specify wich of the other group letter to exclude as direct follower of the given letter :
-				"b":["r","l"],
-				"c":["h","t","k","l","r"],
-				"d":["r"],
-				"f":["r","l"],
-				"g":["r","l"],
-				"h":[],
-				"j":["r"],
-				"k":["r","l","t","h"],
-				"l":["t"],
-				"m":["b","p"],
-				"n":["t","d"],
-				"p":["h","r","s","t","l"],
-				"q":["r","l"],
-				"r":["t","c","d","k","q","h"],
-				"s":["t","c","d","k","q","h"],
-				"t":["r","h"],
-				"v":["r","l"],
-				"w":["r"],
-				"x":["p"],
-				"z":["r","h"],
-			},
-			vowels:{// They always accept consonants at their following
-				"a":["i","u","y"],
-				"e":["i","u","y"],
-				"i":["e","o"],
-				"o":["i","u"],
-				"u":["i"],
-				"y":[],
-			},
-		};
-		
-		const LETTERS_TYPES=Object.keys(markovGraph);
-
-		const CURR_LETTER_MODE=Math.getRandomInArray(LETTERS_TYPES);
-		const POSSIBLE_LETTERS=Object.keys(markovGraph[CURR_LETTER_MODE]);
-		const CURR_LETTER=Math.getRandomInArray(POSSIBLE_LETTERS);
-		
-		var automataState={
-			currentLetterMode:CURR_LETTER_MODE,
-			possibleLetters:POSSIBLE_LETTERS,
-			currentLetter:CURR_LETTER,
-			
-			calculateLetter:function(){
-				
-				this.currentLetter=Math.getRandomInArray(this.possibleLetters);
-				
-				var sameLetters=Object.keys( markovGraph[this.currentLetterMode] );
-				if(!contains(sameLetters,this.currentLetter)){
-					// If we picked from the same group : we don't change of group to pick
-					// If we picked from the other group : we do change of group to pick
-					
-					var otherLetterMode=foreach(LETTERS_TYPES,(item)=>{
-						if(item!==this.currentLetterMode)	return item;
-					});
-					
-					this.currentLetterMode=otherLetterMode;
-				}
-
-			},
-			
-			updatePossibleLettersForLetter:function(){
-				
-				var nextPossibleLetters=[];
-				var nextNotPossibleLetters=[];
-
-				// We store those of the other group marked «^»
-				foreach(markovGraph[this.currentLetterMode][this.currentLetter],(letter)=>{
-					if(letter.charAt(0)==="^"){
-						nextNotPossibleLetters.push(letter.charAt(1));
-					}else{
-						nextPossibleLetters.push(letter);
-					}
-				});
-				
-				var otherLetterMode=foreach(LETTERS_TYPES,(item)=>{
-					if(item!==this.currentLetterMode)	return item;
-				});
-				var otherLetters=Object.keys(markovGraph[otherLetterMode]);
-				
-				// We exclude those marked «^»
-				foreach( otherLetters ,(letter)=>{
-					if(!contains(nextNotPossibleLetters,letter)){
-						nextPossibleLetters.push(letter);
-					}
-				});
-
-				this.possibleLetters=nextPossibleLetters;
-			}
-		};
-		
-		var i=0;
-		do{
-
-			result+=automataState.currentLetter;
-			
-			automataState.updatePossibleLettersForLetter();
-			automataState.calculateLetter();
-			
-			i++;
-		}while(i<length);
-		
-		return result;
-	}
-	
-	for(var i=0;i<length;i++){
-		var	value=Math.getRandomInt(255,0);
-		result+=String.fromCharCode(value);
-	}
-	
-	if(mode==="base64"){
-		return btoa(result);
-	}
-	
-	return result;
-}
-
-
-
-// NOT AOTESTABLE !
-function getUniqueIdWithDate(){
-	return getHashedString(getNow() + "");
-}
-
-
-
-// NOT AOTESTABLE !
-
-//Works, but doesn't compile under PhoneGap...:
-//function getURLParameter(nameParam){
-//var name=encodeURIComponent(nameParam);
-//return decodeURIComponent(
-//(
-//new RegExp('[?|&]' + name + '=' + '([^&;]+?)(&|#|;|$)' )
-//.exec(window.location.search)
-//|| [,""]
-//)[1]
-//.replace(/\+/g, '%20')
-//)||null;
-//}
-
-//...so we replace it with another function that is supposed to do the same
-//thing :
-function getURLParameter(nameParam){
-	var name=nameParam;
-	if (name=new RegExp("[?&]" + encodeURIComponent(name) + "=([^&]*)").exec(location.search))
-		return decodeURIComponent(name[1]);
-	return null;
-}
-
-
-
-
-// A little method to help i18ning aotra user interface :
-const I18N_REPOSITORY_VARIABLE_NAME="I18N_KEYS";
-function i18n(languagesAndStrings, langParam=null){
-	
-	// ******************* CONFIG ******************* 
-	const PREFERED_LANGUAGE="fr"; // My Quebecer wife (love on her for ever and beyond) forced me to set this...(I'm French.)
-	
-	const NO_TRANSLATION_LABEL="NO TRANSLATION FOUND";
-	
-	const ADD_SYSTEMATICALLY_TO_REPOSITORY=true;
-	const MAX_CHARACTERS_FOR_TRANSLATION_KEY=64; // Really if you have more than 64 characters in commons, then it really should be the same string !
-
-	// ***************** END CONFIG ***************** 
-
-	
-	if(!languagesAndStrings){
-		// TRACE
-		console.log("ERROR : No parameter for i18n provided!",languagesAndStrings);
-		return NO_TRANSLATION_LABEL;
-	}
-	
-	let lang=null;
-	if(langParam){
-		lang=langParam;
-	}else{
-		// Parameters priority :
-		if(window){
-			if(window.getURLParameter){
-				lang=nonull(window.getURLParameter("language"), window.getURLParameter("lang"));
-			}
-			if(!lang && (window.language || window.lang)){
-				lang=nonull(window.language, window.lang);
-			}
-		}else if(global){	// (NodeJS compatibility)
-			if(global.getURLParameter){
-				lang=nonull(global.getURLParameter("language"), global.getURLParameter("lang"));
-			}
-			if(!lang && (global.language || global.lang)){
-				lang=nonull(global.language, global.lang);
-			}
-		}
-		lang=nonull(lang, PREFERED_LANGUAGE);
-	}
-	
-	if(contains(["capitalize","append"],lang)){
-		// TRACE
-		console.log("WARN : Language parameter has for value a reserved attribute keyword, using default language «"+PREFERED_LANGUAGE+"»");
-		lang=PREFERED_LANGUAGE;
-	}
-	
-	
-	let result=null;
-	
-	
-	if(!isString(languagesAndStrings)){ // Case direct i18n translation, with no translation keys :
-		
-		result=languagesAndStrings[lang];
-	
-		if (!result){
-			// TRACE
-			console.log("ERROR : No label found for language «"+lang+"»!",languagesAndStrings);
-		}
-	
-		if (!result){
-			for(key in languagesAndStrings){
-				if (!languagesAndStrings.hasOwnProperty(key))
-					continue;
-				// We take the first that we find, in the other languages:
-				result=languagesAndStrings[key];
-				break;
-			}
-		}
-
-		if (!result)	return NO_TRANSLATION_LABEL;
-		
-		
-		// We add this «rogue» usage of i18n to the whole repository at all useful ends :
-		if(ADD_SYSTEMATICALLY_TO_REPOSITORY){
-//		let declarable={};
-			let maxLength=Math.min(result.length, MAX_CHARACTERS_FOR_TRANSLATION_KEY);
-			let key=toConvention("camel", result.substring(0,maxLength).toLowerCase() );
-//		let calculatedKey=radicalKey+"_"+getUUID("short");
-//		declarable[calculatedKey]=languagesAndStrings;
-			i18n.declareSingleEntry(key, languagesAndStrings);
-		}
-
-		// Eventual post-treatments :
-		if(languagesAndStrings.capitalize)	result=capitalize(result);
-		if(languagesAndStrings.append)			result+=languagesAndStrings.append;
-
-		return result;
-	}
-	// else // Case we use translation keys : (here, languagesAndStrings parameter holds just the wished translation key)
-
-	
-	let repository=(window?window:global)[I18N_REPOSITORY_VARIABLE_NAME];
-	if(!repository){
-		// TRACE
-		console.log("ERROR : No repository variable found for repository «"+I18N_REPOSITORY_VARIABLE_NAME+"»!");
-		return NO_TRANSLATION_LABEL;
-	}
-	
-	// OLD (ie. splitted format :)
-//		let repositoryForLang=repository[lang];
-//		if (!repositoryForLang){
-//			// TRACE
-//			console.log("ERROR : No translation found for language «"+lang+"»!",languagesAndStrings);
-//			return NO_TRANSLATION_LABEL;
-//		}
-//		result=repositoryForLang[languagesAndStrings]; // Here, languagesAndStrings is just a bundle key.
-//		if (!result)	return NO_TRANSLATION_LABEL+" (for key «"+languagesAndStrings+"»)";
-	
-	let languagesAndStringsForTranslationKey=repository[languagesAndStrings];
-	if (!languagesAndStringsForTranslationKey){
-		// SILENT ERROR :
-//		// TRACE
-//		console.log("ERROR : No translation found for key «"+languagesAndStrings+"» for language «"+lang+"»!");
-//	NO, OLD : return NO_TRANSLATION_LABEL;
-		return languagesAndStrings;
-	}
-	result=i18n(languagesAndStringsForTranslationKey, lang); // Since we use the same format !
-	
-	return result;
-};
+	return result;
+};
 
 
 i18n.declareSingleEntry=function(key, languagesAndStringsEntry){
@@ -7121,7 +6848,7 @@ createFusrodaClient=function(doOnClientReady, doOnDataReception, urlParam=null,
 
 
 
-/*utils GEOMETRY library associated with aotra version : «1.0.0.000 (11/07/2022-23:45:37)»*/
+/*utils GEOMETRY library associated with aotra version : «1.0.0.000 (12/07/2022-01:46:29)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -8327,7 +8054,7 @@ function rayVsUnitSphereClosestPoint(p, r) {
 // MUST REMAIN AT THE END OF THIS LIBRARY FILE !
 
 AOTRAUTILS_GEOMETRY_LIB_IS_LOADED=true;
-/*utils COMMONS library associated with aotra version : «1.0.0.000 (11/07/2022-23:45:37)»*/
+/*utils COMMONS library associated with aotra version : «1.0.0.000 (12/07/2022-01:46:29)»*/
 /*-----------------------------------------------------------------------------*/
 
 
@@ -9668,105 +9395,398 @@ aotest.run=function(testName=null,scenarioName=null){
 	
 	var buildHRReport=function(resultObj){
 
-		let str="";
-		
-		let resultsFailed=getCumulatedInt(resultObj,"childrenFailed");
-		let resultsRunned=getCumulatedInt(resultObj,"childrenRunned");
-		
+		let str="";
+		
+		let resultsFailed=getCumulatedInt(resultObj,"childrenFailed");
+		let resultsRunned=getCumulatedInt(resultObj,"childrenRunned");
+		
+		
+		// TRACE
+		str+="@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n";
+		str+=" 									AOTEST REPORT								 \n";
+		str+="REPORT: "+resultsFailed + "/" + resultsRunned + " scenarii failed.\n";
+		str+="REPORT: "+(resultsRunned - resultsFailed) + "/" + resultsRunned + " scenarii succeeded.\n";
+		str+="REPORT: "+resultsRunned + " scenarii runned.\n";
+		str+="@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n";
+		
+		if(0<resultsRunned){
+			if(!resultObj.global.isFailed){
+				// TRACE
+				str+="LOG: RESULT :>>>>>> All tests SUCCEEDED ! :D\n";
+			} else {
+				// TRACE
+				str+="LOG: RESULT :>>>>>> Some tests FAILED... :(\n";
+			}
+		} else {
+			// TRACE
+			str+="LOG: RESULT :>>>>>> No tests runned... :|\n";
+		}
+		
+		return str;
+	};
+	
+
+	var getCumulatedInt=function(resultObj, attrName){
+
+		let result=0;
+		
+		result+=resultObj.global[attrName];
+		
+		foreach(resultObj.children,(child)=>{
+			result+=getCumulatedInt(child, attrName);
+		});
+		
+		return result;
+	};
+
+	
+	
+	
+	// TRACE
+	console.log(	buildHRReport(allTestsResultObj));
+	
+	
+	// DBG
+	console.log("TOTAL RESULT :",allTestsResultObj);
+
+	
+	aotest.isRunning=false;
+	
+	return allTestsResultObj;
+};
+
+
+
+aotest.profile=function(rootObject,methodName,visited=[]){
+	
+	
+//if(!rootObject || !isObject(rootObject) || contains(visited,rootObject))	return;
+	if(			!rootObject || isPrimitive(rootObject)	|| isFunction(rootObject) 
+			||  contains(visited,rootObject))	return;
+
+	const THRESHOLD_MILLIS=10;
+
+	visited.push(rootObject);
+	
+	let method=rootObject[methodName];
+	if(method && isFunction(method)){
+		rootObject[methodName]=function(){
+			
+			let time=getNow();
+			
+			method.apply(rootObject, arguments);
+			
+			let deltaMillis=(getNow()-time);
+			
+			// TRACE
+			if(THRESHOLD_MILLIS<=deltaMillis)	lognow("Duration ["+deltaMillis+"ms] of «"+methodName+"» on object:"+getClassName(rootObject),rootObject);
+		};
+	}
+	
+	foreach(rootObject,(attr,attrName)=>{
+		
+		// DBG
+		if(attrName==="currentContainer")	lognow("currentContainer:",attr);
+		
+		aotest.profile(attr,methodName,visited);
+		
+	});
+	
+	
+};
+
+
+
+
+
+//================================================================
+//================= Cryptography utility methods =================
+//================================================================
+
+
+// NOT AOTESTABLE !
+//TODO : develop :
+//getHashedString=monitorProgression(100000,
+window.getHashedString=function(str,/*OPTIONAL*/isHeavyTreatment){
+	
+	//CAUTION : YOU MUST *NOT* CHANGE THIS VALUE, UNLESS THE HASH HEAVY TREATMENT VALUE IN YOUR AOTRA SERVER-SIDE CODEIS THE SAME !
+	const HEAVY_TREATMENT_LOOP_COUNT=100000;
+	
+	if(isHeavyTreatment){
+
+		// If needed, we make sure the hashing will take a long time, so that
+		// if the private salt key is leaked, it will be fairly difficult to crack
+		// password write protection and content encryption :
+		
+		let result=str;
+		for(var i=0;i<HEAVY_TREATMENT_LOOP_COUNT;i++){
+			result=getHashedString(result,false);
+		}
+
+		
+		return result;
+		
+	}else{
+	
+		
+		// SHA-256 hash (sucks less) :
+		// DEPENDENCY : SJCL JS libray (Stanford Javascript Crypto Library)
+		if(typeof(sjcl)!="undefined"){
+			let result=sjcl.codec.hex.fromBits(sjcl.hash.sha256.hash(str));
+			
+			// TODO : develop :
+//			hash.progressionMonitor.progress(1);
+	
+			
+			return result;
+		}
+		
+		// if not found : MD5 hash (sucks) :
+		//TRACE
+		log("WARN : Could not find SHA hashing, using MD5. This sucks, and this very likely will prevent your aotra client to be able to write data to aotra server.");
+		
+		return hex_md5(str);
+	}
+}
+//);
+
+function encrypt(strToEncrypt,key,/*OPTIONAL*/mode){
+	if(!mode || typeof(sjcl)=="undefined")	mode="xor";
+	mode=mode.trim();
+
+	if(contains(mode,"aes") && contains(mode,"xor")){
+
+		// XOR :
+		var xorStr=btoa(encodeXORNoPattern(strToEncrypt,key));	
+		
+		var aesStr=
+			// AES
+			sjcl.encrypt(key,xorStr);
+
+		return aesStr;
+	}
+	
+	//	DEPENDENCY : SJCL JS libray (Stanford Javascript Crypto Library)
+	if(mode==="aes")
+		return sjcl.encrypt(key,strToEncrypt);
+	return btoa(encodeXORNoPattern(strToEncrypt,key));
+
+}
+
+function decrypt(strToDecrypt,key,/*OPTIONAL*/mode){
+	if(!mode || typeof(sjcl)=="undefined")	mode="xor";
+	mode=mode.trim();
+
+	if(contains(mode,"aes") && contains(mode,"xor")){
 		
-		// TRACE
-		str+="@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n";
-		str+=" 									AOTEST REPORT								 \n";
-		str+="REPORT: "+resultsFailed + "/" + resultsRunned + " scenarii failed.\n";
-		str+="REPORT: "+(resultsRunned - resultsFailed) + "/" + resultsRunned + " scenarii succeeded.\n";
-		str+="REPORT: "+resultsRunned + " scenarii runned.\n";
-		str+="@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@@\n";
+		// AES
+		var aesStr=sjcl.decrypt(key,strToDecrypt);
 		
-		if(0<resultsRunned){
-			if(!resultObj.global.isFailed){
-				// TRACE
-				str+="LOG: RESULT :>>>>>> All tests SUCCEEDED ! :D\n";
-			} else {
-				// TRACE
-				str+="LOG: RESULT :>>>>>> Some tests FAILED... :(\n";
-			}
-		} else {
-			// TRACE
-			str+="LOG: RESULT :>>>>>> No tests runned... :|\n";
-		}
+		var xorStr=
+			// XOR :
+			encodeXORNoPattern(atob(aesStr),key);
+
+		return xorStr;
 		
-		return str;
-	};
+	}
 	
+	//	DEPENDENCY : SJCL JS libray (Stanford Javascript Crypto Library)
+	if(mode==="aes")
+		return sjcl.decrypt(key,strToDecrypt);
+	return encodeXORNoPattern(atob(strToDecrypt),key);
+	
+	
+}
 
-	var getCumulatedInt=function(resultObj, attrName){
-
-		let result=0;
+function encodeXORNoPattern(strToEncode,key){
+	let result="";
+	let keyChunk=key;
+	let keyLength=keyChunk.length;
+	let previousChars="";
+	let cnt=0;
+	for(let i=0;i<strToEncode.length;i++){
+		let char=strToEncode.charAt(i);
+		let keyByte=keyChunk.charAt(cnt);
 		
-		result+=resultObj.global[attrName];
+		result+=String.fromCharCode(char.charCodeAt(0)^keyByte.charCodeAt(0));
 		
-		foreach(resultObj.children,(child)=>{
-			result+=getCumulatedInt(child, attrName);
-		});
+		if(cnt%keyLength===(keyLength-1)){
+			cnt=0;
+			// NO : TOO LONG TREATMENT !: We hash with all the previous blocks too :
+			// We hash with a character of the previous chunk (they add up at each new chunk):
+			keyChunk=getHashedString(previousChars+keyChunk);
 		
-		return result;
-	};
+			previousChars+=keyChunk.charAt(keyChunk.length-1);
+		}else{
+			cnt++;
+		}
+	}
+	return result;
+}
 
+function generateRandomString(length,/*NULLABLE*/mode){
 	
+	// This list must be very conservative, because  we want to be able to pass it through GET URLs !
+	// OLD (not enough conservative ?) : const ALLOWED_CHARS="abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0912346789_-£¢¤¬²³¼½¾";
+	const ALLOWED_CHARS="abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0912346789!-:;";
 	
 	
-	// TRACE
-	console.log(	buildHRReport(allTestsResultObj));
-	
+	if(typeof(length)==="string"){
+		if(contains(length,"->")){
+			length=Math.getRandomInRange(length);
+		}else{
+			length=64;
+		}
+	}
 	
-	// DBG
-	console.log("TOTAL RESULT :",allTestsResultObj);
+	var result="";
 
-	
-	aotest.isRunning=false;
-	
-	return allTestsResultObj;
-};
+	if(mode==="simple"){
+		
+		for(var i=0;i<length;i++){
+			var	value=Math.getRandomInArray(ALLOWED_CHARS);
+			result+=value;
+		}
+		
+		return result;
+	}else if(mode==="human"){
+		
+		const markovGraph={
+			// For simplicity sakes, we ignore the consonants and vowels doubling possibilities:
+			consonants:{// They always accept vowels at their following
+				// Indicate ^ to specify wich of the other group letter to exclude as direct follower of the given letter :
+				"b":["r","l"],
+				"c":["h","t","k","l","r"],
+				"d":["r"],
+				"f":["r","l"],
+				"g":["r","l"],
+				"h":[],
+				"j":["r"],
+				"k":["r","l","t","h"],
+				"l":["t"],
+				"m":["b","p"],
+				"n":["t","d"],
+				"p":["h","r","s","t","l"],
+				"q":["r","l"],
+				"r":["t","c","d","k","q","h"],
+				"s":["t","c","d","k","q","h"],
+				"t":["r","h"],
+				"v":["r","l"],
+				"w":["r"],
+				"x":["p"],
+				"z":["r","h"],
+			},
+			vowels:{// They always accept consonants at their following
+				"a":["i","u","y"],
+				"e":["i","u","y"],
+				"i":["e","o"],
+				"o":["i","u"],
+				"u":["i"],
+				"y":[],
+			},
+		};
+		
+		const LETTERS_TYPES=Object.keys(markovGraph);
 
+		const CURR_LETTER_MODE=Math.getRandomInArray(LETTERS_TYPES);
+		const POSSIBLE_LETTERS=Object.keys(markovGraph[CURR_LETTER_MODE]);
+		const CURR_LETTER=Math.getRandomInArray(POSSIBLE_LETTERS);
+		
+		var automataState={
+			currentLetterMode:CURR_LETTER_MODE,
+			possibleLetters:POSSIBLE_LETTERS,
+			currentLetter:CURR_LETTER,
+			
+			calculateLetter:function(){
+				
+				this.currentLetter=Math.getRandomInArray(this.possibleLetters);
+				
+				var sameLetters=Object.keys( markovGraph[this.currentLetterMode] );
+				if(!contains(sameLetters,this.currentLetter)){
+					// If we picked from the same group : we don't change of group to pick
+					// If we picked from the other group : we do change of group to pick
+					
+					var otherLetterMode=foreach(LETTERS_TYPES,(item)=>{
+						if(item!==this.currentLetterMode)	return item;
+					});
+					
+					this.currentLetterMode=otherLetterMode;
+				}
 
+			},
+			
+			updatePossibleLettersForLetter:function(){
+				
+				var nextPossibleLetters=[];
+				var nextNotPossibleLetters=[];
 
-aotest.profile=function(rootObject,methodName,visited=[]){
-	
-	
-//if(!rootObject || !isObject(rootObject) || contains(visited,rootObject))	return;
-	if(			!rootObject || isPrimitive(rootObject)	|| isFunction(rootObject) 
-			||  contains(visited,rootObject))	return;
+				// We store those of the other group marked «^»
+				foreach(markovGraph[this.currentLetterMode][this.currentLetter],(letter)=>{
+					if(letter.charAt(0)==="^"){
+						nextNotPossibleLetters.push(letter.charAt(1));
+					}else{
+						nextPossibleLetters.push(letter);
+					}
+				});
+				
+				var otherLetterMode=foreach(LETTERS_TYPES,(item)=>{
+					if(item!==this.currentLetterMode)	return item;
+				});
+				var otherLetters=Object.keys(markovGraph[otherLetterMode]);
+				
+				// We exclude those marked «^»
+				foreach( otherLetters ,(letter)=>{
+					if(!contains(nextNotPossibleLetters,letter)){
+						nextPossibleLetters.push(letter);
+					}
+				});
 
-	const THRESHOLD_MILLIS=10;
+				this.possibleLetters=nextPossibleLetters;
+			}
+		};
+		
+		var i=0;
+		do{
 
-	visited.push(rootObject);
-	
-	let method=rootObject[methodName];
-	if(method && isFunction(method)){
-		rootObject[methodName]=function(){
-			
-			let time=getNow();
-			
-			method.apply(rootObject, arguments);
+			result+=automataState.currentLetter;
 			
-			let deltaMillis=(getNow()-time);
+			automataState.updatePossibleLettersForLetter();
+			automataState.calculateLetter();
 			
-			// TRACE
-			if(THRESHOLD_MILLIS<=deltaMillis)	lognow("Duration ["+deltaMillis+"ms] of «"+methodName+"» on object:"+getClassName(rootObject),rootObject);
-		};
+			i++;
+		}while(i<length);
+		
+		return result;
 	}
 	
-	foreach(rootObject,(attr,attrName)=>{
-		
-		// DBG
-		if(attrName==="currentContainer")	lognow("currentContainer:",attr);
-		
-		aotest.profile(attr,methodName,visited);
-		
-	});
+	for(var i=0;i<length;i++){
+		var	value=Math.getRandomInt(255,0);
+		result+=String.fromCharCode(value);
+	}
 	
+	if(mode==="base64"){
+		return btoa(result);
+	}
 	
-};
+	return result;
+}
+
+
+
+// NOT AOTESTABLE !
+function getUniqueIdWithDate(){
+	return getHashedString(getNow() + "");
+}
+
+
+
+
+
+
+//================================================================
+//================= Miscelanneous utility methods =================
+//================================================================
+
 
 
 

aotrautils/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "aotrautils",
-	"version": "0.0.52",
+	"version": "0.0.55",
 	"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)",